飞书文档批量导出只用三步一条命令同步整个知识库彻底告别手动下载【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export周一早会刚结束领导丢来一句话公司要从飞书切回企业微信知识库里 700 多篇文档一周内全部迁走。你打开飞书看着文档列表陷入沉思——一篇篇点开、下载、保存按每篇 2 分钟算100 篇就要 3 个多小时还得时刻担心目录结构乱掉、格式丢光。如果你也被这种场面困住过那这篇要讲的 feishu-doc-export 飞书文档批量导出工具正好能把 700 篇的活儿压到 25 分钟而且是后台挂着跑不影响你干别的。30 秒速览它到底能做什么feishu-doc-export 是一个基于 .NET Core 开发的飞书文档导出服务支持 Windows、Mac、Linux 三种系统一条命令就能把整个知识库或个人空间某个文件夹的文档同步到本地输出 docx、markdown、pdf 三种格式目录结构保持和飞书原样一致。对比维度手动下载feishu-doc-export100 篇文档耗时3 小时以上5 分钟左右目录结构要自己重建与飞书完全一致文档格式复制粘贴易错乱docx / md / pdf 任选中途断网前功尽弃单篇失败自动跳过整体不中断第一步拿到飞书 API 凭证动手前先准备两个钥匙App ID 和 App Secret。去飞书开发者后台创建一个企业自建应用信息随便填重点是开权限。在权限管理里开通云文档相关的查看、导出权限比如查看、评论和下载云空间中所有文件导出云文档查看、编辑和管理知识库这几项再给应用加上机器人能力发布一个版本等待管理员审核通过。然后回到凭证与基础信息页面App ID 和 App Secret 就在这里先复制保存好。小提示如果只想本地测试可以创建测试企业并绑定应用切到测试版本再建一个测试知识库来练手不会影响正式环境。凭证到手后接下来就是关键一步——把工具下载下来。第二步下载程序并授权克隆源码或用 Release 版本都行# 克隆项目源码 git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-export按系统选择压缩包Windows 用feishu-doc-export-win-x64.zipMac 用mac-osx-x64Linux 用linux-x64。解压后Windows 的可执行文件是feishu-doc-export.exeMac 和 Linux 是没后缀的feishu-doc-export。Mac 和 Linux 用户注意首次使用要先把文件变成可执行# 把文件授权为可执行文件 sudo chmod x ./feishu-doc-export执行时建议加sudo否则可能因为权限不足连保存文档的目录都建不出来——这个坑很多人踩过。第三步执行导出命令程序下载好了最后一步就是运行。最简单的导出命令只有三个必填参数# Windows 示例 ./feishu-doc-export.exe --appId你的AppId --appSecret你的AppSecret --exportPathE:\文档备份 # Mac / Linux 示例 sudo ./feishu-doc-export --appId你的AppId --appSecret你的AppSecret --exportPath/home/文档备份不传--spaceId时程序会列出你有权限的所有知识库让你输入序号选择适合不确定知识库 ID 的情况指定了就直接导适合写进脚本做自动化。常用参数再记一份参数作用是否必填--appId/--appSecret飞书应用凭证必填--exportPath导出到本地的目录必填--spaceId指定知识库 ID选填--typewiki 或 cloudDoc默认 wiki选填--folderToken导出个人空间时填文件夹 Token条件必填--saveTypedocx / md / pdf默认 docx选填比如导出个人空间的某个文件夹并转成 Markdown命令长这样# Windows 导出个人空间文档为 Markdown ./feishu-doc-export.exe --appIdxxx --appSecretxxx --saveTypemd --exportPathE:\temp\test --typecloudDoc --folderTokenxxx手动 vs 工具差距到底在哪手动下载慢不只是操作多更坑的是过程不可控。网络一抖、电脑一卡下载到一半的进度说没就没。而 feishu-doc-export 的思路完全不同程序逐篇创建飞书导出任务、轮询结果、下载落盘单篇失败会记录日志并跳过其余文档照常继续所以 700 多篇跑 25 分钟跑完还能给你列一张哪些没导成功的清单方便你单独补。至于内部实现看懂大概结构就行飞书接口的调用封装在src/feishu-doc-export/HttpApi/格式转换和文件处理在src/feishu-doc-export/Helper/主流程在Program.cs文档路径映射交给DocumentPathGenerator.cs和CloudDocPathGenerator.cs处理——想二次开发可以从这几个目录下手。实战场景一企业知识库整体迁移最典型的用法就是开头的场景。拿企业自己的 App 凭证指定知识库 ID一步到位# 导出整个知识库为 docx保存到本地备份目录 ./feishu-doc-export --appId企业AppId --appSecret企业AppSecret --spaceId知识库ID --exportPath/企业文档备份命令跑起来之后你可以正常去开会、写代码程序在后台安静地干活跑完看一眼日志清单就行。实战场景二定期备份 纳入版本管理需要定期备份的团队可以把这个命令塞进 cron 定时任务每个月自动生成一份备份目录#!/bin/bash # 创建月度备份目录 BACKUP_DIR/backup/feishu/$(date %Y-%m) mkdir -p $BACKUP_DIR # 执行批量导出保存为 markdown ./feishu-doc-export --appId$APP_ID --appSecret$APP_SECRET --exportPath$BACKUP_DIR --saveTypemd技术团队还可以把导出的 Markdown 直接丢进 Git 仓库文档变更一目了然# 导出到项目 docs 目录 ./feishu-doc-export --appId$APP_ID --appSecret$APP_SECRET --saveTypemd --exportPath./docs # 提交到版本控制 git add . git commit -m docs: 更新飞书文档备份 $(date %Y-%m-%d) git push避坑指南这几个坑提前帮你踩过Q1导出时报权限错误怎么办多半是应用权限没开全或机器人没进知识库。核对三点权限管理里该开的文档权限是否都开了、应用版本是否已发布上线、机器人是否被添加到了知识库的管理员群组。Q2知识库 ID 和文件夹 Token 去哪找知识库 ID 看飞书知识库的 URLspace/后面的那串字符串就是。个人空间文件夹 Token 更简单右键文件夹获取链接folderToken后面的值就是。Q3Markdown 导出有格式丢失这是已知限制。工具是先调飞书接口下载 docx再用 Aspose.Words 转成 Markdown所以引用语法、表格、行内代码块这类格式可能丢。追求完美排版就用 docx 或 pdfMarkdown 更适合当纯文本备份。Q4文件名太长导不出来系统对文件名长度有限制超长的文档会被自动跳过并记进日志清单。遇到这种情况改短飞书里的文档名再单独补导即可。现在就可以动手回到开头那个 700 篇的迁移任务创建应用、开通权限、下载程序、跑一条命令25 分钟后本地就多了一份和飞书结构一致的完整备份。与其花一下午点鼠标不如花 10 分钟把飞书文档批量导出跑起来。现在就可以去开发者后台创建你的应用完成飞书文档导出工具的第一步配置让文档迁移这件事从此只花一杯咖啡的时间。【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考