飞书文档批量导出怎么做：一条命令25分钟同步700个知识库文档（完整指南）

飞书文档批量导出怎么做：一条命令25分钟同步700个知识库文档（完整指南）

【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export

想把飞书文档批量导出到本地，一条命令就够了：开源项目 feishu-doc-export 把整个知识库逐篇拉到你的磁盘上，700 多个文档实测约 25 分钟跑完。它是个跨 Windows、macOS、Linux 的命令行工具，输出 docx、md、pdf 三种格式，表格和多维表格自动落成 xlsx。

整篇文章按"拿凭证 → 跑通第一条命令 → 扩展用法"的顺序讲，你跟着做完，自己就能把这个工具跑起来。

飞书知识库导出工具适合谁

• 做迁移的团队：公司换办公平台，知识库要限期整体搬走。手动下载平铺在文件夹里，层级和表格排版全得靠手工救，这个工具导出的目录与飞书一一对应。
• 要定期备份的人：希望每月自动把知识库或个人空间文件夹备一份，按时间归档，不用人盯。
• 技术团队：想把导出的 Markdown 放进 Git 仓库，让每次文档大改版都有本地快照可回溯。

顺带说下它的来历：作者的 700 多份文档要迁出飞书，试过的现成工具要么网页版打包下载量大就慢到像卡死，要么一次只能导一篇，于是自己写了个工具解决这个实际需求，不是演示项目。

准备工作：先拿凭证，再下载工具

整个准备流程约 15 分钟，按编号做就行：

1. 创建企业自建应用（约 5 分钟）：进入飞书开发者后台新建应用，基础信息随意填。
2. 开通云文档权限（约 2 分钟）：在"权限管理"里开启查看新版文档、导出云文档、查看编辑知识库、查看导出电子表格与多维表格等权限。权限列表是分页的，翻页确认别漏项。
3. 添加机器人并发布版本（约 2 分钟）："应用能力"里添加机器人，再到"版本管理与发布"创建版本、申请上线，等企业管理员审核。只想快速验证的话，建测试企业、绑定应用、切到测试版本即可。
4. 给机器人知识库权限（约 3 分钟）：在飞书客户端把自建应用作为群机器人拉进一个群，然后打开目标知识库"知识空间设置 → 成员管理 → 添加管理员"，选中这个群。机器人从此能访问该知识库。
5. 复制凭证（1 分钟）：回开发者后台"凭证与基础信息"，复制 App ID 和 App Secret，对应后面命令里的--appId和--appSecret。
6. 下载程序（约 1 分钟）：Release 页按系统选包。Windows 选feishu-doc-export-win-x64.zip，解压后是可执行文件feishu-doc-export.exe；macOS 选feishu-doc-export-mac-osx-x64.zip，Linux 选feishu-doc-export-linux-x64.zip，后两者无后缀。想自己编译源码的话，克隆仓库：

# 可选：克隆源码自行编译 git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-export

要导**个人空间（云文档）**的，授权方式不同：把目标文件夹分享给自建应用，再从分享链接里提取folderToken备用。

安全方面说三句：全程 API 通信走 HTTPS，AppSecret 只在内存里换令牌、不落盘；工具只读和导出，不改动飞书里的任何内容；按最小权限原则只开导出必需的权限，并确认自己拥有对应知识库或文件夹的访问权。

一条命令批量导出实操

Linux / macOS 首次使用必须先给执行权限，否则会报权限错误：

# Linux / macOS 首次使用：授予执行权限 sudo chmod +x ./feishu-doc-export

接着跑最小命令——导出所有你有权限的知识库，默认 docx 格式：

# 最小示例：导出全部知识库为 docx ./feishu-doc-export --appId=你的AppId --appSecret=你的AppSecret --exportPath=/home/backup/feishu

运行后程序会列出你有权限的知识库清单，输入序号回车就开始逐篇下载，每篇都打印一条进度。Windows 用户把路径换成E:\backup\feishu这种盘符路径即可。

去哪看结果：打开--exportPath指向的目录，子目录层级和飞书知识库的目录树一致；表格、多维表格是 xlsx，知识库里的 PDF、图片等文件也一并下了。什么算成功：结尾终端打印"文档已全部导出"，导出目录结构和知识库左侧大纲能对上。个别没导出来的文档会列在结尾清单里，手动补下即可。

它为什么快？三点：直接走飞书开放平台 API 拿文档清单和下载地址，没有浏览器操作；先取全量节点再按父子关系递归生成每篇的落盘路径，token、导出任务、轮询、下载这条调用链封装在src/feishu-doc-export/HttpApi/里；单篇失败单独捕获记入清单、不中断整批，Markdown 则是先下 docx 再用 Aspose.Words 转换。

进阶用法：三种省事的备份姿势

配成定时任务让它自己跑

用 cron 每月自动备一份、按月份归档，适合对文档安全敏感的团队。关键是--quit参数：导出完自动退出，不会停在"按任意键退出"那行，脚本调用必须带上。

# 每月自动备份：按年月建归档目录，导出为 pdf BACKUP_DIR="/backup/feishu/$(date +%Y-%m)" ./feishu-doc-export --appId=$APP_ID --appSecret=$APP_SECRET \ --exportPath="$BACKUP_DIR" --saveType=pdf --quit

把飞书文档纳入 Git 版本管理

导出 Markdown 提交进仓库，飞书里每次大改版，本地都有历史版本可查：

# 导出到仓库 docs 目录，然后提交 ./feishu-doc-export --appId=$APP_ID --appSecret=$APP_SECRET \ --saveType=md --exportPath=./docs git add . && git commit -m "docs: 同步飞书文档备份"

格式怎么选？

三种格式速度和用途不同，对号入座：

# 指定知识库做迁移导出，保存为 Markdown ./feishu-doc-export --appId=xxx --appSecret=xxx \ --spaceId=知识库ID --saveType=md --exportPath=/data/migrate/wiki

参数速查表与性能建议

全部命令行参数一览：

性能建议三条：

• 速度排序 docx > md > pdf，pdf 因图片内嵌最慢；实际速度还受网速、飞书服务器响应和磁盘写入影响。
• 导出目录放 SSD，几百个文件写入时和普通硬盘的差距明显。
• 超大知识库按子知识库分批导出，方便逐批核对遗漏。

常见问题速查

1. 导出报权限错误？原因：应用权限没开全、机器人所在的群没加进知识库管理员组，或版本未发布上线。 解决：按准备工作第 2、4 步逐项核对，确认版本已审核通过；测试环境记得切到测试版本。

2. Markdown 导出有格式丢失？原因：工具先把文档下成 docx 再转 md，引用块、表格、行内代码等语法转换中会失真，转换逻辑在src/feishu-doc-export/Helper/DocxToMdFormatHelper.cs。 解决：对格式要求高的文档直接用 docx 或 pdf 导出。

3. 有文档没导出来？原因：文件名超过 64 个字符会因系统命名限制被跳过；个别文件类型不受支持。 解决：把超长文件名改短后重跑；不支持的类型在运行结尾的"无法导出"清单里列着，手动下载补齐。

4. Linux / mac 提示无法创建目录？原因：当前用户对导出目录没有写权限。 解决：用sudo运行命令，或确保导出目录对当前用户可写。

5. 找不到 spaceId 或 folderToken？原因：这两个值不在应用界面里，而是藏在 URL 中。 解决：知识库 ID 在飞书知识库地址的space/之后；个人空间文件夹 Token 在文件夹分享链接的folderToken=参数里。

写在最后

回到开头的数字：700 多个文档、约 25 分钟，本地目录和飞书知识库一一对应，全程不用手工搬运。如果你的飞书里也存着大量重要文档，从最小命令开始——先把自己能看到的知识库按 docx 导一遍，看看效果，再按需要接上格式切换、定时备份或版本管理。🚀

【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export