飞书文档批量导出完整指南如何一条命令把 700 篇知识库文档搬回本地【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export公司一周内要从飞书切走700 篇知识库文档必须全部迁出。手动导出每篇 4 步、全程盯守怎么也得一天一夜。feishu-doc-export 一条命令就能批量导出整个知识库到本地实测 25 分钟跑完。先算笔账700 篇手动要 24 小时一条命令只要 25 分钟feishu-doc-export 是一个支持 Windows、macOS、Linux 的开源命令行工具把飞书知识库或个人空间云文档整体导出为docx、md、pdf三种格式表格和多维表格自动转成xlsx。差距有多大直接看这张表对比项手动下载feishu-doc-export700 篇文档耗时约 24 小时纯手工按每篇 2 分钟估算约 25 分钟官方实测单篇操作打开、导出、选格式、选保存位置共 4 步0 步程序全代劳目录层级平铺在下载文件夹逐层手工重建按父节点递归还原与知识库一一对应表格 / 多维表格复制粘贴容易乱版自动导出为 xlsx单篇出错 / 断网进度归零从头再来其余文档照常下载失败项最后统一列出参与程度全程盯守后台挂机可以干别的看懂 3 个设计点它为什么敢做批量导出直连飞书开放平台 API不模拟浏览器操作。拉取文档清单、创建导出任务、轮询结果、下载文件全部走官方接口没有网页端反复跳转的开销。整条调用链封装在src/feishu-doc-export/HttpApi/目录里。按父子关系递归还原本地目录树。先一次性取回知识库全部节点再按父节点递归生成每篇文档的落盘路径见DocumentPathGenerator.cs文件名里的非法字符会被自动替换成-迁移完不用二次整理。单篇文档失败单独隔离不连坐。每篇文档都套了独立的异常捕获失败的和暂不支持的类型记入清单全部导完后统一打印其余文档不受影响主流程见Program.cs。至于 md 格式思路是先通过接口拿到 docx再用 Aspose.Words 转成 Markdown把格式转换交给成熟库见src/feishu-doc-export/Helper/DocxToMdFormatHelper.cs。10 分钟跑通授权发出你的第一条导出命令完整上手共 4 步合计大约 10~15 分钟。第 1 步建自建应用并开通权限5~8 分钟打开飞书开发者后台创建一个企业自建应用基础信息随意填写。在权限管理开通云文档相关 8 项权限查看新版文档、查看评论和下载云空间中所有文件、查看评论和导出文档、查看评论编辑和管理云空间中所有文件、查看评论编辑和管理多维表格、查看编辑和管理知识库、查看评论编辑和管理电子表格、导出云文档。注意权限列表是分页的翻页确认不漏项。在应用能力中添加机器人能力到版本管理与发布创建版本并申请上线需管理员审核想快速验证可以创建测试企业、绑定应用并切换测试版本。最后在凭证与基础信息页复制App ID和App Secret。第 2 步给机器人授权目标知识库3~5 分钟在飞书客户端建一个群已有群也行把自建应用添加为群机器人。打开目标知识库 → 知识空间设置 → 成员管理 → 添加管理员选中刚才的群。至此机器人就有了该知识库的访问权限。知识库 ID 可不填它就藏在知识库网址space/后面不传--spaceId时程序会自动列出你有权限的全部知识库输入序号即可。第 3 步下载程序并赋予执行权限1 分钟到项目 Release 页按系统选包解压Windows 选feishu-doc-export-win-x64.zip可执行文件带.exemacOS 选-mac-osx-x64.zipLinux 选-linux-x64.zip无后缀。想自己编译源码的话git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-exportLinux / macOS 首次使用必须先授予执行权限否则报权限错误sudo chmod x ./feishu-doc-export第 4 步执行最小导出命令先创建好导出目录目录不存在时程序会提示并退出然后运行./feishu-doc-export --appId你的AppId --appSecret你的AppSecret --exportPath/home/backup/feishu程序会列出可导出的知识库输入序号回车开始跑完去目标目录看层级结构和飞书里完全一致。Windows 用户把路径换成E:\backup\feishu即可。全部参数速查参数必填说明--appId/--appSecret是自建应用凭证--exportPath是导出目录需提前创建--spaceId否知识库 ID不填则列出全部知识库供选择--type否wiki默认或cloudDoc--folderToken条件必填--typecloudDoc时必填--saveType否docx/md/pdf默认 docx--quit否导出结束自动退出适合脚本调用--apiEndpoint否使用 Lark 国际版时指定 API 地址挑一个场景照抄3 种贴近业务的用法用法一正式归档和二次加工各导一份格式归档部门要 docx 留底技术团队要 Markdown 喂给文档站同一个知识库跑两遍、各取所需# 导出为 markdown 供二次加工 ./feishu-doc-export --appIdxxx --appSecretxxx --spaceId知识库ID --saveTypemd --exportPath/data/wiki-md导 md 时文档里的图片会自动存到 md 同级的images目录并改为相对路径引用表格和多维表格无论哪种格式都固定落成 xlsx。用法二每月 1 号凌晨自动全量备份对文档安全敏感的团队用 cron 把备份交给闹钟。两个关键点--quit让程序跑完自动退出、不卡在按任意键导出目录要先mkdir -p建好程序不会替你创建# crontab -e 添加一行每月 1 号凌晨 3 点备份到以月份命名的目录 0 3 1 * * mkdir -p /backup/feishu/$(date \%Y\%m) cd /opt/feishu-doc-export sudo ./feishu-doc-export --appIdxxx --appSecretxxx --spaceId知识库ID --exportPath/backup/feishu/$(date \%Y\%m) --quit用法三备份个人空间的云文档文件夹知识库是团队的个人空间里攒的资料同样值得备份。先将要导出的文件夹分享给自建应用让它拿到导出权限再从分享链接里取出folderToken./feishu-doc-export --appIdxxx --appSecretxxx --typecloudDoc --folderToken文件夹Token --exportPath/home/backup/mydocs注意飞书对个人空间 API 有登录限制所以程序无法列出个人文件夹列表folderToken必须手动提供。遇到报错先查这里5 个高频问题一次解决❓症状导出时报权限错误或提示没有可支持导出的知识库。原因云文档权限没开全列表分页容易漏项、机器人没被加进知识库管理员组或应用版本还没审核上线。 解法按第 1 步逐项核对权限重新把群加为管理员确认版本已发布或已切换测试版本。❓症状导完了本地却少了几篇文档。原因文件名超过 64 个字符会被安全跳过系统命名限制或该文档类型暂不支持。 解法失败清单会在导出结束时统一打印改名后重跑或对照清单手动补下。❓症状md 导出来引用块、表格、行内代码丢失或走样。原因已知限制——工具先下载 docx 再转 Markdown部分语法在转换环节会失真。 解法对格式要求高的文档直接用--saveTypedocx或pdf。❓症状导 pdf 明显比导 docx 慢。原因pdf 需要内嵌图片、写入量更大官方实测 docx 最快、pdf 最慢实际还受网速和磁盘影响。 解法批量导出优先选 docx导出目录放在 SSD 上。❓症状Linux / macOS 报权限不够或无法创建目录。原因可执行文件没授予执行权限或导出目录对当前用户不可写。 解法先执行sudo chmod x ./feishu-doc-export仍不行就用sudo运行或换一个当前用户可写的目录。最后确认两件事数据只进你自己的磁盘整个导出过程都在本地完成文档内容直接落盘到你的机器AppSecret仅用于在内存中换取访问令牌不会被写进任何文件所有调用走飞书开放平台 HTTPS 接口工具只做读取与导出不改动飞书里的任何内容。跑之前确认两件事你对目标知识库或文件夹有访问权限且只按最小化原则开通了导出所需的那 8 项权限。回到开头那个被 deadline 追着的夜晚——700 篇文档现在只需要一条命令和 25 分钟换来的是一个目录结构完整的本地知识库镜像。第一步零门槛打开飞书开发者后台建一个自建应用10 分钟后你就能看到第一条导出命令跑起来。【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
