飞书文档批量导出一条命令搬空整个知识库700个文档只需25分钟【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export周五下午五点运维老周接到通知公司要从飞书切换到企业微信700多个文档周一前必须全部迁完。三个人点鼠标下载了一下午连一百个都没搞定格式还丢了一地。当晚他找到了开源项目 feishu-doc-export——一个飞书文档批量导出命令行工具跑了一条命令25分钟全部落地目录层级和飞书里分毫不差。一句话定位feishu-doc-export 基于 .NET Core 开发跨 Windows/macOS/Linux 运行把整个飞书知识库或个人空间文件夹一次性同步到本地支持 docx、markdown、pdf 三种格式目录结构原样保留。适合正在做平台迁移的团队、需要定期备份知识库的企业以及想把文档纳入 Git 管理的技术团队。它的设计巧思先画地图再搬货 ️批量导出最反直觉的一点是它不一个个处理文档而是先画地图再照着地图搬货。程序启动后先递归拉取知识库的全部节点生成一份文档路径映射表源码里对应DocumentPathGenerator相当于分拣中心先给每个包裹贴上目的地标签再交给流水线按序装车——所以导出的目录结构和飞书完全一致而不是一地散文件。第二个巧思是掉队不翻车单篇文档导出失败会被记入清单、继续往后走绝不中断整批任务跑完再把失败清单列给你手动补齐。相比网页版工具全部打包成一个压缩包、中途断网就白等的设计稳得多。导出任务查询还带 10 次自动重试网络抖一下也能自己缓过来。第三个能力是覆盖面不止纯文档文档里附带的 pdf、图片等文件也会被下载知识库和个人空间两种来源都能导靠--type参数切换。和现有方案摆在一起差距一眼可见对比项网页版备份工具单文档命令行工具feishu-doc-export一次能导多少打包下载慢且易卡死一次一篇整个知识库目录结构部分保留需手动整理完全一致中途失败断网全部重来无此问题单篇跳过末尾出清单上手指南从申请凭证到拿到文件三步走 第一步准备——申请飞书应用凭证约10分钟在飞书开放平台的开发者后台创建企业自建应用信息随意填权限管理里开通云文档相关权限注意有分页查看新版文档、查看评论和下载云空间中所有文件、查看评论和导出文档、导出云文档、查看编辑和管理知识库等添加应用能力 → 添加机器人在版本管理与发布创建一个版本并申请上线测试可切换到测试企业飞书客户端建一个群把应用机器人加进群再把该群添加为知识库的管理员回到凭证与基础信息记下 App ID 和 App Secret第二步运行——一条命令触发整库导出获取源码或直接下载对应系统的 Release 压缩包git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-exportmacOS/Linux 首次使用先授权可执行权限sudo chmod x ./feishu-doc-export然后按需执行把尖括号里的内容替换成你的值# Windows导出知识库为 docx ./feishu-doc-export.exe --appIdAppId --appSecretAppSecret --spaceId知识库ID --exportPathE:\文档备份 --saveTypedocx # Windows导出个人空间文件夹为 markdown ./feishu-doc-export.exe --appIdAppId --appSecretAppSecret --exportPathE:\文档备份 --typecloudDoc --folderToken文件夹Token --saveTypemd# macOS / Linux建议用 sudo避免目录创建权限不足 sudo ./feishu-doc-export --appIdAppId --appSecretAppSecret --exportPath/home/backup/feishu --saveTypemd几个参数的含义--spaceId是知识库 ID不传时程序会列出你有权限的所有知识库输入序号即可选择--saveType取 docx/md/pdf不传默认 docx--type取 wiki默认或 cloudDoc。第三步验证——对照原目录验收成果导出结束后把本地目录和飞书知识库层级逐层对比随机打开几篇确认图片与表格正常。程序末尾会输出总耗时和未能导出清单照着清单补那几篇漏网之鱼就行。老周那晚的结果是700多个文档、25分钟、目录零偏差只有 3 篇因文件名超过 64 字符被跳过清单上写得明明白白。避坑手册四个高频翻车现场 现象 1提示没有可支持导出的知识库 原因应用版本没发布上线或机器人没被设为知识库管理员。 解决确认版本已申请并审核通过在知识库空间设置 → 成员管理里把包含机器人的群添加为管理员。现象 2macOS/Linux 运行时报目录创建失败 原因可执行文件没授权或当前用户对导出目录无写权限。 解决先执行sudo chmod x ./feishu-doc-export执行时带上sudo。现象 3导出个人空间文档时反复失败 原因忘了传--typecloudDoc和--folderToken或目标文件夹没分享给应用。 解决在飞书中把文件夹分享给自建应用授权其导出再补全两个参数。现象 4markdown 导出后引用、表格、行内代码块丢失 原因这是设计使然——md 是借飞书接口先下载 docx再用 Aspose.Words 转 markdowndocx 阶段就丢了一部分格式。 解决对格式有洁癖的文档改用 docx 或 pdfmarkdown 适合内容可读、便于版本管理的场景。进阶玩法让备份自己跑起来 技巧一cron 定时任务实现无人值守备份。Linux/macOS 每周一凌晨自动导出一次0 2 * * 1 cd /opt/feishu-doc-export sudo ./feishu-doc-export --appIdxxx --appSecretxxx --exportPath/backup/feishu-$(date \%Y\%m\%d) --saveTypedocx技巧二把 markdown 导出目录接进 Git。导出后git add . git commit -m docs: 同步飞书文档文档当代码管周报时一条 diff 就能看清本周改了什么。另外如果你们用的是 Lark 国际版加参数--apiEndpointhttps://open.larksuite.com即可适配。最后给你算笔账 指标手动逐个下载feishu-doc-export100个文档耗时3小时起步3-5分钟目录结构散乱需手工整理与飞书完全一致中途断网前功尽弃失败单篇记录可补导占用人力一个人专职点鼠标挂机即可老周后来感慨早知道有这东西下午三个人也不至于点到手酸。如果你手头也有几百个待迁移、待备份的飞书文档与其打开浏览器一篇篇点不如把这件事交给一行命令sudo ./feishu-doc-export --appId你的AppId --appSecret你的AppSecret --exportPath备份目录回车去冲杯咖啡。等你回来整个知识库已经整整齐齐地在本地等你了。【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考