一条命令 25 分钟导出 700 份文档feishu-doc-export 飞书文档批量导出完整指南【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export一条命令700 多份飞书文档 25 分钟落到本地磁盘——这是我用feishu-doc-export做飞书文档批量导出的实测成绩。它是一个开源的命令行工具专门把整个飞书知识库团队共享的文档空间或云文档文件夹同步到本地目录层级原样保留docx、md、pdf 三种格式任选。如果你正面临文档迁移、定期备份或版本化管理这篇文章就是为你写的从申请凭证到跑通第一条命令全程大约 15 分钟。它是什么一条命令跑完飞书知识库备份feishu-doc-export 是一个专注飞书文档批量导出的开源命令行工具输入应用凭证和目标目录它就能把你名下有权限的知识库整体搬到本地。它不走网页打包下载也不止一次导一篇而是异步批量拉取我实测 700 文档平均约 0.5 篇/秒100 个文档约 3~5 分钟跑完。上手过程就三步拿凭证、解压程序、跑命令。能力一句话说明目录层级还原本地结构与飞书知识库一一对应迁移后不用二次整理多格式导出支持 docx / md / pdf 三种格式默认 docx表格自动处理表格与多维表格自动导出为 xlsx不会乱版附件一并下载知识库内的 PDF、图片等文件类型一起拉下来失败隔离单篇失败不中断整体结尾统一输出失败清单为什么快、为什么稳飞书文档批量导出的难点从来不是下载一个文件而是大批量、保结构、不断档。这个工具的快与稳来自三个机制像一条流水线取单、分单、出货各自独立任何一站出问题整条线不停摆。1. 直连官方 API不模拟浏览器。程序直接调用飞书开放平台接口获取文档清单与导出任务异步批量拉取省掉网页端反复跳转的开销。token 获取、任务创建、结果轮询、文件下载的完整调用链封装在 HTTP 调用链 中。2. 先遍历再递归还原目录树。知识库文档有父子层级程序先遍历全部节点再按父子关系递归生成每篇文档的本地落盘路径导出结果与飞书结构一一对应逻辑见 路径生成逻辑。3. 单篇失败不拖垮整体。每篇文档单独捕获异常失败的记入清单、最后统一打印其余照常下载文件名超长等问题文档被安全跳过而不是让整个任务崩掉。至于 Markdown 转换思路是先拿 docx、再转 md把格式转换交给成熟库自己专注调度与路径处理。从申请凭证到第一条命令从零基础到跑通第一条命令我实测约 15 分钟大头在第一步的凭证申请。拿凭证飞书自建应用授权五步在飞书开发者后台新建一个企业自建应用相当于一个有官方身份的代行者你授权它就能替你调接口基础信息随意填写。在权限管理开通云文档的查看、下载、导出权限和知识库的查看、编辑权限。注意权限列表是分页的翻页确认别漏项。在应用能力添加机器人能力再到版本管理与发布创建版本并申请上线只想快速验证的话可以创建测试企业、绑定应用并切换到测试版本。建一个群把自建应用加为群机器人再打开目标知识库的知识空间设置 → 成员管理 → 添加管理员选中这个群机器人就拿到了知识库访问权限。回到凭证与基础信息复制 App ID 和App Secret也就是命令里的--appId与--appSecret。要导出个人空间云文档的话授权方式不同先把目标文件夹分享给自建应用再从分享链接里提取folderToken备用。选包下载跑第一条命令按系统选压缩包Windows 是feishu-doc-export-win-x64.zip可执行文件带.exe后缀macOS 是-mac-osx-x64.zipLinux 是-linux-x64.zip。想自己编译源码的可以克隆仓库git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-export后自行构建。Linux / macOS 首次使用必须先授予执行权限# 授予执行权限Linux / macOS 首次必做 sudo chmod x ./feishu-doc-export然后是最小可运行命令——导出你所有可见的知识库# 最小示例导出全部可见知识库docx 为默认格式 ./feishu-doc-export --appId你的AppId --appSecret你的AppSecret --exportPath/home/backup/feishu运行后程序自动列出你有权限的知识库输入序号回车即可开始Windows 用户把路径换成E:\backup\feishu这样的盘符路径。跑完打开目标目录看一眼层级结构和飞书里完全一致。三种用法定时备份、整体迁移与 Git 版本化定时备份。如果希望飞书知识库备份像定期体检一样准时出现可以把命令交给 cron 定时任务系统内置的到点自动执行器每月跑一次、按月份归档。关键是--quit参数它让程序导出结束后自动退出不会停在按任意键退出那一行是脚本化调用的必选项。# 每月备份创建带年月标识的归档目录--quit 让程序结束后自动退出 mkdir -p /backup/feishu/$(date %Y-%m) ./feishu-doc-export --appId$APP_ID --appSecret$APP_SECRET --exportPath/backup/feishu/$(date %Y-%m) --saveTypepdf --quit整体迁移。切换协作平台时把整个知识库一次性导出把飞书文档导出 Markdown 格式方便到新平台后二次加工表格自动落成 xlsxPDF、图片等附件一并下载几乎不用二次补漏。# 指定知识库导出为 Markdown适合迁移后二次加工 ./feishu-doc-export --appIdxxx --appSecretxxx --spaceId知识库ID --saveTypemd --exportPath/data/migrate/wikiGit 版本化。技术团队可以把导出的 Markdown 直接放进 Git 仓库飞书里的每次大改版本地都留有一份历史快照。# 导出 Markdown 到仓库目录后提交版本并推送 ./feishu-doc-export --appId$APP_ID --appSecret$APP_SECRET --saveTypemd --exportPath./docs git add . git commit -m docs: 同步飞书文档备份 git push origin main参数手册全部参数与性能建议参数必填作用--appId是飞书自建应用的 App ID--appSecret是飞书自建应用的 App Secret--exportPath是文档导出的保存目录--spaceId否知识库 ID不填则列出全部知识库交互选择--type否导出对象wiki默认或cloudDoc个人空间--folderToken--typecloudDoc时必填个人空间文件夹 Token从分享链接提取--saveType否保存格式docx/md/pdf默认 docx--quit否导出结束后自动退出脚本与定时任务必带--apiEndpoint否指定 API 地址Lark 国际版环境时配置两条性能建议我实测 docx 导出最快md 与 docx 接近pdf 最慢图片需内嵌写入量更大实际速度还受网速、飞书服务器响应和磁盘写入速度影响。导出目录尽量放 SSD 上超大知识库可以按子知识库分批导出方便逐批核对遗漏。边界与排错先说清楚这套飞书文档批量导出工具的边界转 Markdown 时引用块、表格、行内代码等语法可能失真转换逻辑见 Markdown 转换逻辑文件名超过 64 个字符的文档会被直接跳过个别文档类型不受支持程序不会崩溃而是把它们记进清单让你手动补。以下是 feishu-doc-export 使用过程中最高频的几个问题。❓一运行就报权限问题九成是授权没做全要么应用权限没开齐要么装机器人的群没被加进知识库管理员组。按上文五步逐条核对同时确认应用版本已审核上线测试环境记得切到测试版本。❓spaceId 与 folderToken 去哪儿拿spaceId 就在飞书知识库 URL 的space/后面folderToken 在个人空间文件夹分享链接的folderToken参数里。❓导完后发现缺了几篇两种常见情况文件名超过 64 个字符会被跳过改名后重跑即可个别类型不受支持失败清单会在程序结尾统一打印照着清单手动补下就行。❓Linux / mac 建目录失败怎么办用sudo运行或确认导出目录对当前用户可写。安全与合规整套飞书文档批量导出过程都在你的本地机器完成文档内容直接写入磁盘App Secret 仅在内存中换访问令牌、不落盘API 通信全程 HTTPS。工具只做读取与导出不修改飞书里的任何内容它基于飞书官方开放平台开发使用前确认你拥有对应知识库或文件夹的权限只开通导出必需的权限即可。如果你的飞书里也存着几百份重要文档建议今天就从上面那条最小命令开始先挑一个你有权限的知识库试跑一遍。把 700 文档的备份压缩到 25 分钟这种确定性比什么都值钱 【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考