飞书文档批量导出实战：一条命令把700+知识库文档备份到本地

飞书文档批量导出实战一条命令把700知识库文档备份到本地【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export假如你所在的公司要从飞书迁移到其他协作平台而知识库里躺着700多个文档——手动一个个下载至少需要一整天还保不住原有的目录结构。这正是 feishu-doc-export 要解决的飞书文档批量导出难题它是一款基于 .NET Core 的跨平台命令行工具一条命令即可将整个飞书知识库或个人空间云文档同步到本地支持 docx、markdown、pdf 三种格式实测 700 文档仅需 25 分钟且全程可后台挂机运行。结论先行它能帮你省下多少时间先看一组直观对比。假设你的知识库里有 100 个需要备份的文档对比维度手动逐个下载feishu-doc-export预计耗时3 小时以上5 分钟左右目录结构完全打乱需人工整理与飞书原结构一致表格/多维表格需另存为格式易错自动转 xlsx 导出中断风险断网即前功尽弃单文档失败自动跳过工具的核心能力可以概括为三点全量递归一次导出知识库下的所有文档无需逐个指定结构保真导出后的本地目录层级与飞书知识库完全一致找文档和找备份同样方便三格式可选docx 适合存档、md 适合进 Git 仓库、pdf 适合对外分发。它凭什么快一次导出背后的工作流程知其然也要知其所以然。feishu-doc-export 的快来自对飞书开放平台 API 的合理编排整个导出过程大致分五步调用知识库接口递归拉取空间下全部节点文档、表格、文件根据节点的父子关系生成本地路径映射确保目录结构一致为每个文档创建飞书导出任务轮询任务状态直到就绪下载导出文件并按映射路径写入本地磁盘若选择 markdown 格式则先下载 docx再用 Aspose.Words 转换并修复图片与文档引用路径。如果你对实现细节感兴趣源码里的模块划分很清晰API 调用集中在src/feishu-doc-export/HttpApi/目录格式转换与文件处理在src/feishu-doc-export/Helper/目录路径映射则分别由DocumentPathGenerator.cs知识库和CloudDocPathGenerator.cs个人空间负责读起来不费力。第一步在飞书开放平台配置API凭证动手导出之前需要先让飞书认识你的程序。整个过程约 10 分钟一次性配置之后即可反复使用。1. 创建企业自建应用进入飞书开发者后台点击创建企业自建应用名称和描述随意填写即可。创建完成后进入应用的后台管理页。2. 开通云文档相关权限在权限管理中开通以下权限注意列表有分页务必翻页查看查看新版文档查看、评论和下载云空间中所有文件查看、评论和导出文档查看、评论、编辑和管理云空间中所有文件查看、评论、编辑和管理多维表格查看、评论、编辑和管理电子表格导出云文档查看、编辑和管理知识库3. 添加机器人能力并发布上线在添加应用能力中为应用添加机器人然后在版本管理与发布中创建版本并申请发布等待企业管理员审核通过。如果只想测试可以在测试企业下绑定应用并切换到测试版本自行创建知识库和文档。4. 给机器人放行知识库在飞书桌面客户端新建一个群组把刚创建的应用作为群机器人添加进去接着打开知识库的知识空间设置 → 成员管理 → 添加管理员选择这个群组。这样机器人就获得了该知识库的读取与导出权限。5. 取回凭证与知识库 ID回到开发者平台的凭证与基础信息即可看到App ID和App Secret这两个值就是后续命令的钥匙。知识库 ID 则藏在知识库页面的 URL 里——space/后面的那一串字符串即是。第二步下载程序跑通第一条导出命令根据操作系统选择对应压缩包Windows 用户下载feishu-doc-export-win-x64.zipMac 用户下载feishu-doc-export-mac-osx-x64.zipLinux 用户下载feishu-doc-export-linux-x64.zip。解压后Windows 的可执行文件是feishu-doc-export.exeLinux 和 Mac 则是无后缀的feishu-doc-export。最简单的导出命令只需要三个必填参数# 克隆项目源码也可直接下载预编译版本 git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-export # Windows ./feishu-doc-export.exe --appId你的AppId --appSecret你的AppSecret --exportPathE:\文档备份 # Mac / Linux sudo ./feishu-doc-export --appId你的AppId --appSecret你的AppSecret --exportPath/home/文档备份不传--spaceId时程序会列出当前账号下所有可导出的知识库你只需输入序号即可选择适合首次使用。完整的参数速查表如下参数说明是否必填--appId飞书自建应用的 App ID必填--appSecret飞书自建应用的 App Secret必填--exportPath文档导出的本地目录必填--spaceId知识库 ID选填不填则交互选择--typewiki知识库或cloudDoc个人空间默认 wiki选填--saveTypedocx、md、pdf默认 docx选填--folderTokentype 为 cloudDoc 时必填按需--apiEndpoint指定 API 地址如https://open.larksuite.com用于 Lark 环境选填--quit导出结束后自动退出适合自动化场景选填Mac / Linux 用户请留意两点首次使用需先执行sudo chmod x ./feishu-doc-export赋予执行权限运行时建议加sudo否则可能因权限不足而无法创建目录。第三步按需选择导出范围与格式导出个人空间云文档是知识库之外的高频场景操作同样不复杂先把要导出的文件夹分享给自建应用然后在分享链接中提取folderToken后面的值最后执行./feishu-doc-export.exe --appIdxxx --appSecretxxx --typecloudDoc --folderToken文件夹Token --saveTypemd --exportPathE:\temp\test需要说明的是个人空间因飞书做了登录限制未登录状态下列举文件夹列表的 API 无法调用所以工具只支持按指定文件夹导出不支持浏览选择这是平台限制而非工具缺陷。三种格式怎么选下表基于项目作者的实测结论格式速度适用场景注意点docx最快本地存档、二次编辑推荐首选md与 docx 相当纳入 Git 版本管理存在格式丢失pdf最慢图片内嵌对外分发、归档适合量小的场景坦白讲markdown 导出目前存在已知的格式局限引用语法、表格、行内代码块会在 docx 转 md 的过程中丢失。原因是该工具先调用飞书接口下载 docx再做二次转换而 docx 阶段已产生了格式损耗。如果你的文档包含大量复杂表格建议直接用 docx 导出需要完美视觉呈现再考虑 pdf。稳定性与自动化挂机导出也不怕批量导出最怕一颗老鼠屎坏了一锅粥这个工具在容错上做了不少功课单点失败不中断某个文档导出异常会被记录并跳过其余文档继续导出最后统一输出无法导出清单任务查询重试导出任务状态查询失败会自动重试最多 10 次降低网络抖动的影响超长文件名兜底超过系统命名长度限制的文档会被自动忽略并提示避免整批任务报错支持后台自动化加上--quit参数后程序执行完毕自动退出配合 cron 定时任务即可实现飞书文档定期备份。下一步从今天开始备份你的知识库与其在需要迁移的那天才手忙脚乱不如现在就花 10 分钟配置好飞书自建应用跑通第一条导出命令。获取工具git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-export或直接下载对应平台的预编译版本。一次配置、一条命令、25 分钟完成 700 飞书文档批量导出——把文档备份这件事彻底交给自动化。【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考