飞书知识库怎么整体备份700 多篇文档 25 分钟全部落到本地【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export上季度我们部门要把一个 700 多篇文档的飞书知识库整体迁走期限三天。按手动下载的节奏一小时撑死 20 篇显然来不及。后来我改用开源工具 feishu-doc-export 做飞书文档批量导出一条命令把整个知识库同步到本地实测 700 多篇只花 25 分钟。下面是我完整走一遍的流程从申请凭证到核对结果。先说结论700 篇文档两种搬法各花多少对比项手动逐篇下载feishu-doc-export700 篇耗时一整天起步需全程盯守实测约 25 分钟后台挂机知识库层级平铺在同一目录手工重建目录树自动与飞书一致表格 / 多维表格复制粘贴易乱版自动导出为 xlsx中途出错进度作废重新来过失败单篇单独记录其余继续人力投入每篇都要点击导出一条命令可同时干别的手动导出飞书文档的四个卡点层级会丢飞书知识库动辄嵌套三四层手动下载全部平铺在同一个目录结构要一篇篇手动归位。表格会乱版电子表格、多维表格靠复制粘贴格式几乎必坏网页端也拿不到结构化的表格文件。断了要重来手动导出没有进度概念中途断网或电脑卡死之前做的全部作废。现有工具有短板有的网页工具把整批文档打包成压缩包才返回量大时等待极久有的命令行工具一次只能导出一篇。需求就很清楚了整库一次导出、目录保真、出错不中断。feishu-doc-export 做的就是这件事并支持 docx、md、pdf 三种保存格式。快速上手从建应用到跑通导出5 分钟建应用拿到 AppId 和 AppSecret在飞书开发者后台创建一个「企业自建应用」基础信息随意填写。在「权限管理」开通 8 项云文档权限查看新版文档查看、评论和下载云空间中所有文件查看、评论和导出文档查看、评论、编辑和管理云空间中所有文件查看、评论、编辑和管理多维表格查看、编辑和管理知识库查看、评论、编辑和管理电子表格导出云文档。权限列表有分页注意翻页别漏。「应用能力」里添加机器人再到「版本管理与发布」创建版本并申请上线等企业管理员审核只想快速验证可创建测试企业并切换到测试版本。把机器人拉进任意群然后到知识库的「知识空间设置 → 成员管理 → 添加管理员」里选这个群机器人即获得该知识库访问权限。回到「凭证与基础信息」复制 App ID 和 App Secret。要导出个人空间云文档则跳过第 4 步把目标文件夹分享给自建应用再从分享链接里提取 folderToken。按系统选压缩包给文件执行权限从项目 Releases 页选择对应系统Windows 是feishu-doc-export-win-x64.zipmacOS 是feishu-doc-export-mac-osx-x64.zipLinux 是feishu-doc-export-linux-x64.zip。解压后 Windows 可执行文件为feishu-doc-export.exe其余两个平台无后缀。Linux / mac 首次使用必须授权执行# Linux / mac 首次使用给可执行文件赋予执行权限 sudo chmod x ./feishu-doc-export跑通第一条命令交互式选知识库导出目录要提前建好否则程序会提示目录不存在直接退出。在可执行文件所在目录运行这条最小命令# 最小示例不指定知识库程序列出可用知识库输入序号开始导出 sudo ./feishu-doc-export --appId你的AppId --appSecret你的AppSecret --exportPath/home/backup/feishu不传--spaceId时程序会列出你有权限的全部知识库输入序号即可开始默认保存为 docx。Windows 用户去掉sudo把路径换成E:\backup\feishu这类盘符路径即可。三步验证导出结果对比顶层目录打开导出目录确认一级文件夹与知识库顶层节点一一对应。抽查深层路径在飞书里找一篇三四层深的文档看本地是否落在同样的目录层级下。看结尾清单程序结束时会统一打印「无法导出的文档」清单清单为空说明没有遗漏有则按清单补齐。三个能直接跑的导出场景整库迁移顺便备一份 Markdown。新平台导入前常要批量改文档直接导 md表格自动落成 xlsx知识库里的 pdf、图片等文件类文档也会一并下载# 指定知识库 ID 导出为 Markdown 到迁移目录 ./feishu-doc-export.exe --appIdxxx --appSecretxxx --spaceId知识库ID --saveTypemd --exportPathE:\migrate\wiki每月定时备份按月份归档。把命令写进 crontab 就能无人值守--quit让程序导出完直接退出不会停在「按任意键退出」是脚本化调用的关键# 月度备份示例导出到月份目录完成后自动退出 ./feishu-doc-export --appId$APP_ID --appSecret$APP_SECRET --exportPath/backup/feishu/2026-08 --saveTypepdf --quit文档进 Git留下版本历史。技术团队把导出的 md 提交进仓库飞书里每次大改版本地都有快照可追溯# 导出到仓库 docs 目录然后提交并推送 ./feishu-doc-export --appId$APP_ID --appSecret$APP_SECRET --saveTypemd --exportPath./docs git add . git commit -m docs: 同步飞书文档备份 git push origin main导出又快又稳的三个设计原因全程走飞书开放平台官方接口不模拟浏览器。获取文档清单、创建导出任务、轮询任务结果、下载文件整条调用链都封装在 HttpApi 目录里省掉了网页端反复跳转的开销访问令牌到期也会自动重新获取。先取全量节点再递归落盘目录一比一还原。程序拿到知识库全部节点后按父子关系递归生成每篇文档的落盘路径实现见 DocumentPathGenerator.cs。文件名里的非法字符也会被自动替换本地结构无需二次整理。每篇文档独立捕获异常失败不连坐。单篇出错只记入「无法导出」清单其余照常下载文件名超长、类型不支持的文档安全跳过最后统一打印方便手动补齐。Markdown 转换也是同一思路先通过官方接口拿 docx再用成熟的 Aspose.Words 转成 md自己专注调度和路径。命令行参数速查与导出提速建议参数作用说明--appId应用凭证必填--appSecret应用凭证必填--exportPath导出目录必填目录需提前创建--spaceId知识库 ID不传则列出全部知识库交互选择--type导出对象wiki默认或cloudDoc个人空间--folderToken个人空间文件夹 Token--typecloudDoc时必填--saveType保存格式docx默认/md/pdf--apiEndpointAPI 地址使用 Lark 国际版环境时配置--quit导出后自动退出不等待按键适合定时任务与脚本提速建议实测 docx 最快md 与 docx 接近pdf 最慢图片内嵌、写入量更大。导出目录放 SSD实际速度还受网速和飞书服务器响应影响。超大知识库按子知识库分批导出方便逐批核对遗漏。四个高频问题的处理办法❓导出时报权限错误最可能是 8 项权限没开全或机器人没加进知识库管理员组。重查权限列表的翻页、重新添加群管理员并确认应用版本已审核上线。❓Markdown 转换后格式丢了已知限制先 docx 再转 md引用块、表格、行内代码可能丢失。格式要求高的文档直接用 docx 或 pdf 导出。❓部分文档没导出来常见两种文件名超 64 字符被跳过、文档类型不支持。改名后重跑或按结尾清单手动补下。❓Linux / mac 提示无法创建目录权限不足。用sudo运行并确保导出目录已存在且当前用户可写。工具能力边界只读导出数据落本地工具只做读取和导出不会修改飞书里的任何内容。文档文件直接写入你本地磁盘AppSecret 仅在内存中用于换取访问令牌不做持久化存储API 通信均走 HTTPS。使用前提是你对相应知识库或文件夹有访问权限并遵守飞书开放平台的调用规范按最小化原则只开导出所需的权限即可。回到开头那个三天期限建应用、下程序、跑一条命令就这三步。如果你的飞书里也躺着大量文档建议从最简的导出命令开始先验证目录结构再谈格式与定时任务。【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考