ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

飞书文档批量导出,一条命令把700篇文档搬回家

飞书文档批量导出,一条命令把700篇文档搬回家 飞书文档批量导出一条命令把700篇文档搬回家【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export周五下午钉钉群弹出一则通知公司要从飞书切回企业微信历史文档请自行备份。我盯着知识库里的共 713 篇文档明白手动一篇篇下载是行不通的。feishu-doc-export 这个飞书文档批量导出工具就是为了这种时刻准备的——它的作者当初和我一样面对七百多篇文档的迁移任务试遍了网上现成的工具最后干脆用 .NET 自己写了一个顺手开源了出来。一句话说清楚它是什么feishu-doc-export 是一个跨平台的飞书文档批量导出工具一条命令就能把整个知识库或个人空间文件夹按原来的目录结构同步到本地支持 docx、markdown、pdf 三种格式实测 713 篇文档约 25 分钟跑完。适合谁任何需要把飞书文档整体迁移、定期备份或者转存到本地统一管理的人。不需要会写代码照着我下面的步骤来就行。从拿到工具到跑通我的第一次批量导出经历先交代前置准备这部分花的时间比下载程序本身久得多——飞书的安全机制决定了第三方应用得先拿到门票。你要去飞书开发者后台创建一个企业自建应用开通云文档相关的几项权限查看、导出、管理知识库等发布版本等管理员审核再把应用以机器人身份加进要导出的知识库。这一步的每一步都可能卡壳我在避坑指南里细说。拿到 App ID 和 App Secret 后程序本体三分钟就位git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-exportWindows 解压后是feishu-doc-export.exeLinux 和 Mac 用户先chmod x一下。第一次运行我偷懒没填知识库 ID程序直接把能访问的知识库列表打出来让我输序号——这对新手很友好不用先搞懂 spaceId 是什么。./feishu-doc-export --appId我的AppId --appSecret我的AppSecret --exportPath/home/backup/feishu回车后屏幕上开始一行行滚动正在导出文档——1.【xxx】像一条进度流水。我把它扔在后台该开会开会。约二十五分钟后回来命令行显示文档已全部导出总耗时 1523 秒顺带列出了几篇因格式不支持或文件名超长被跳过的文档。打开导出目录第一反应是也太整齐了——知识库里的层级文件夹、子页面原封不动地躺在本地对应目录里。不想碰命令行的话双击程序按提示一步步输入也行两种方式我在 Windows 和 Linux 上都试过结果一致。三个让我觉得这设计挺聪明的地方目录结构不是摆进去的是算出来的。程序先递归遍历整个知识库把所有文档的父子关系整理成一张 token 到路径的映射表再按图落盘。打个比方这就像搬家时先给书房画一张书架示意图每本书按原位置归位而不是把书倒进纸箱再重新排。更妙的是知识库内部互相引用的文档导出后会改写成相对路径——本地打开 A 文档点链接直接跳到旁边的 B 文档知识库的内网在本地依然通着。单篇失败不会拖垮整批。每个文档的导出都单独捕获异常失败了就跳过、记下来继续下一个最后统一打印一份没导成的清单。我在网络不稳定的环境下跑过一次中途断了两次程序自动重试最后只有三篇需要手动补。批量任务最需要的性格就是这种不追求完美、但保证不中断的取舍。markdown 不是从云端直接拿而是二次加工。飞书官方接口能直接给 docx程序就先下载 docx再用 Aspose.Words 转成 md并整理图片和链接路径。作者很诚实地标注了这种做法的代价引用语法、表格、行内代码块会丢。知道每个格式的短板在哪里比一味吹嘘全格式无损靠谱得多——要最完整的版式选 docx 就对了。数据说话25分钟700篇和手动下载差多远713 篇、25 分钟是作者实测的数字我这次跑也基本吻合。三种格式里 docx 最快md 和它差不多pdf 最慢图片要内嵌进文件。如果只是备份存档docx 是性价比最高的选择。方式700篇耗时目录结构中途断网手动一篇篇下载一整天起步手还会酸全靠自己整理前功尽弃feishu-doc-export约25分钟后台跑与知识库完全一致自动重试不中断另外作者动手前调研过两个同类工具一个网页版下载慢、打包等待长、还不支持表格另一个一次只能下载一篇。这个工具把两个短板都补上了——表格sheet、多维表格会导出成 xlsx知识库和个人空间云文档都能整批导出。你可能踩过的坑我先替你踩了看不到知识库或报权限错误十有八九是应用没发布上线或者机器人没被加进知识库的管理员里。先查这两处再查权限是否开全。Linux/Mac 上 Permission denied忘了chmod x或者没加sudo。保存文档时创建目录需要写权限。导出 md 后表格、引用全乱了这是二次转换的已知短板不是 bug。追求版式就用 docx。个别文档被跳过常见原因是文件名超过 64 个字符或类型不支持结尾的失败清单会告诉你具体是哪几篇手动补一下即可。导出个人空间文件夹先把文件夹分享给自建应用再用--typecloudDoc --folderTokenxxx指定。受飞书登录限制个人空间不支持列出文件夹列表这个工具也没有硬做。把备份变成一件不用想的事飞书文档的备份迁移说白了就是搬书——真正累人的不是搬是搬完之后的整理和返工。feishu-doc-export 把最脏最累的批量动作变成一条命令剩下的时间留给真正重要的事。下次需要把知识库整体搬走或者想给重要文档做定期备份的时候不妨试试这条命令。25 分钟后你会感谢那个把 713 篇文档一键搬回家的自己。【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表