25 分钟搬走 700 篇飞书文档飞书文档批量导出一次讲透feishu-doc-export【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export如果你的飞书知识库里有几百上千篇文档要迁走或备份feishu-doc-export 可以一条命令把它们全部同步到本地磁盘知识库、个人空间云文档都能导docx / md / pdf 三种格式任选项目实测 700 多篇文档约 25 分钟跑完全程无需人工盯守。这篇文章覆盖从申请凭证到跑通导出的最短路径外加常用参数速查和踩坑清单全文只有 4 段可直接运行的示例代码适合需要做知识库迁移、定期备份的团队成员和运维同学15 分钟能读完。一、它解决什么问题能做到哪些事手动导出文档意味着每篇都要打开、点导出、选格式、挑保存位置一个知识库几百篇文档下来目录层级乱了、表格排版花了中途断网还可能白干一场。feishu-doc-export 把这些活全部自动化知识库wiki和个人空间云文档cloudDoc都支持批量导出一条命令启动本地目录树与飞书层级一一对应导出后不用再手工整理电子表格、多维表格自动落成 xlsxPDF、图片等文件类型文档也一并下载支持 docx、md、pdf 三种保存格式默认 docx单篇文档出错不会中断任务失败的文档最后统一列出清单Windows、macOS、Linux 三个平台都有对应的单文件可执行程序适合谁负责团队知识库迁移的负责人、需要定期做文档备份的运维、想把文档纳入版本管理的技术团队。二、跑起来从凭证到第一条导出命令整个上手过程拆成四步前两步在飞书开发者后台完成第三步解压即用环节要做的事大致耗时创建企业自建应用开发者后台建应用开通云文档查看、下载、导出相关权限5~8 分钟给知识库授权建群把应用加为群机器人再把该群加为知识库管理员3~5 分钟下载并解压程序按系统选对应压缩包1 分钟执行导出终端运行一条命令取决于文档量三步拿到授权凭证在飞书开发者后台创建企业自建应用基础信息随意填。进入权限管理把云文档相关的权限逐项打开查看新版文档、查看/评论/下载云空间文件、导出云文档、查看和编辑知识库等。注意权限列表是分页的翻完所有页再走开。给应用添加机器人能力创建版本并申请上线等企业管理员审核只想快速验证的话可以建一个测试企业并切换到测试版本。之后在飞书里建一个群把应用作为群机器人拉进群再打开目标知识库的知识空间设置 → 成员管理 → 添加管理员选中这个群。机器人从此能读到该知识库。最后回到凭证与基础信息页复制 App ID 和 App Secret 备用。下载对应系统的程序包按系统选 Release 里的压缩包Windows 是feishu-doc-export-win-x64.zip可执行文件带.exe后缀macOS 与 Linux 分别是-mac-osx-x64.zip和-linux-x64.zip文件无后缀。想自己编译源码也可以先克隆仓库# 克隆源码可选多数人直接下 Release 包更省事 git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-exportLinux 和 macOS 首次运行必须先加执行权限否则会报权限错误sudo chmod x ./feishu-doc-export一条命令开始导出下面是最小可运行示例导出所有可见的知识库# 导出全部可见知识库格式默认 docx ./feishu-doc-export --appId你的AppId --appSecret你的AppSecret --exportPath/home/backup/feishu不传--spaceId时程序会先列出你有权限的知识库输入序号回车即开始。Windows 下把路径换成E:\backup\feishu这类盘符路径即可Linux 下建议加sudo运行避免保存文档时因权限不足建不了目录。验证方法跑完后打开--exportPath指定的目录如果子目录层级、文档文件名和飞书里的知识库结构一致说明导出成功程序结束时还会打印失败清单空清单即全部成功。三、为什么值得用25 分钟对一整天的差距先看核心数据700 多篇文档导到本地总共约 25 分钟平均每秒处理 0.5 篇左右。换算一下同样这批文档手动导出至少要一整天纯操作时间这个差距决定的是要不要加班而不是快慢。对比维度手动逐篇导出feishu-doc-export100 篇文档所需时间3~4 小时3~5 分钟700 篇文档所需时间一整天起步约 25 分钟失败的影响范围一次中断全部重来单篇跳过任务继续表格 / 多维表格粘贴易乱版需逐个检查自动导出为 xlsx目录层级平铺下载手工重建与线上结构一致过程中的参与成本全程盯守后台挂机即可快和稳来自三个设计直接调用官方开放接口。文档清单、导出任务、下载地址全部走飞书 API 异步批量拉取不做任何模拟浏览器的操作省掉了网页端反复跳转的开销。整条调用链换 token、建导出任务、轮询结果、下载文件都封装在 HttpApi 目录 里像图书管理员整箱搬书而不是逐本誊抄。递归还原目录树。程序先遍历知识库的全部节点再按父子关系为每篇文档算出落盘路径核心逻辑在 DocumentPathGenerator.cs。就像快递分拣按地址逐级归位本地结构自然和线上一致。单篇失败不连坐。每篇文档单独捕获异常失败的记入清单、最后统一打印其余照常下载文件名超长等问题文档会被安全跳过而不是让整个任务崩溃。四、用好它三个场景和完整参数表场景一知识空间整体迁移。换协作平台时指定知识库并导出为 Markdown方便在新平台二次加工./feishu-doc-export --appIdxxx --appSecretxxx --spaceId知识库ID --saveTypemd --exportPath/data/migrate/wiki。表格和多维表格会自动落成 xlsx知识库里的 PDF、图片等文件也会一并下载。场景二定期自动备份。把导出命令包进一个小脚本配合 cron 每月执行一次、按月份归档目录脚本末尾加--quit参数让程序结束后自动退出、不卡在按任意键那一行。适合对文档安全敏感的团队。场景三文档纳入 Git 版本管理。技术团队把 Markdown 导出到仓库目录跑完命令后git add提交即可飞书里每次大改版本地都留有历史快照。完整参数速查参数作用必填 / 说明--appId/--appSecret应用凭证必填--exportPath导出目录必填--spaceId知识库 ID可空不传则列出全部知识库供选择--type导出对象wiki或cloudDoc可空默认wiki--folderToken个人空间文件夹 Token--typecloudDoc时必填--saveType保存格式docx/md/pdf可空默认docx--quit结束后自动退出可选脚本与定时任务必加--apiEndpoint指定 API 地址使用 Lark 国际版时配置两条实用建议导出目录尽量放在 SSD 上大批量写入时差别明显超大知识库可以按子空间分批导出每批结束核对一遍遗漏。另外 docx 最快md 与 docx 接近pdf 最慢图片需内嵌写入量更大实际速度还受网速和飞书服务器响应影响。五、避坑指南常见问题速查❓导出时报权限错误九成是权限没配齐要么应用权限没开全要么机器人所在的群没被加为知识库管理员。回到给知识库授权一节逐项核对并确认应用版本已审核上线测试环境记得切换到测试版本。❓Markdown 格式有丢失已知限制工具先下载 docx 再基于 Aspose.Words 转成 md转换逻辑见 DocxToMdFormatHelper.cs引用块、表格、行内代码容易失真。对格式要求高的文档直接选 docx 或 pdf 更稳妥。❓个别文档没导出来最常见原因是文件名超过 64 个字符被系统命名限制跳过改名后重跑即可不支持的文档类型会在结尾统一列出清单手动补下就行。❓Linux / macOS 报无法创建目录用sudo运行或确认导出目录对当前用户有写权限。数据边界说明全部下载动作发生在你自己的机器上App Secret 仅在内存中用于换取访问令牌不做持久化存储工具只读取和导出不会修改飞书里的任何内容。遵循最小权限原则开通导出所需的必要权限即可。三步就能用上先在开发者后台申请 AppId / AppSecret并完成知识库授权再下载对应系统的压缩包Linux / macOS 记得chmod x最后跑一条最小导出命令25 分钟后核对目录结构。数据握在自己手里永远比依赖在线平台更让人安心 【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
