30 分钟跑通 feishu-doc-export：飞书知识库批量导出的完整实测清单

30 分钟跑通 feishu-doc-export飞书知识库批量导出的完整实测清单【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export本文带你用一条命令完成飞书文档批量导出feishu-doc-export 可以把整个知识库同步到本地自动还原目录结构实测 700 多篇文档总耗时约 25 分钟。全程我走了一遍下面按实际顺序记录每一步该做什么、该看到什么。一、值不值得用30 秒版feishu-doc-export 是一个跨 Windows / macOS / Linux 的飞书文档批量导出命令行工具基于飞书开放平台接口开发支持 docx、md、pdf 三种导出格式同时覆盖知识库和个人空间云文档两种对象。适合三类人团队整体迁移、需要定期备份文档、想把文档纳入 Git 版本管理。先看一组数据判断要不要继续读对比项手动逐篇下载feishu-doc-export700 篇文档耗时约 2 分钟/篇一整天起步实测约 25 分钟目录结构平铺在 Downloads需手工重建层级自动与飞书知识库一致表格 / 多维表格复制粘贴易乱版自动导出为 xlsx中途出错断网即前功尽弃单篇失败跳过并记录其余照常导出二、动手前准备系统Windows / macOS / Linux 的 x64 版本均可程序为单文件可执行程序无需安装 .NET 环境。飞书凭证一个企业自建应用的 AppId 和 AppSecret获取方式见下节。易错点权限管理列表是分页的翻完再开别漏项。知识库授权把自建应用对应的群机器人加进目标知识库的管理员组缺这步会报权限错误。导出目录提前建好程序检测到目录不存在会直接退出建议放在 SSD导出速度更稳。三、完整上手步骤步骤 1申请应用凭证并授权知识库做什么拿到--appId/--appSecret要用的凭证并让应用获得知识库访问权。怎么做在飞书开发者后台创建企业自建应用权限管理中开通云文档相关权限查看新版文档、导出云文档、查看、评论和编辑知识库等注意翻页添加机器人能力在版本管理与发布中创建版本并等管理员审核上线只想验证可先建测试企业建一个群把应用加为群机器人再到目标知识库知识空间设置 → 成员管理 → 添加管理员选中该群。应该看到什么凭证页能复制出 AppId 和 AppSecret知识库管理员列表里出现该群组。卡点提示个人空间的授权方式不同——把要导出的文件夹分享给自建应用再从分享链接里取folderToken。步骤 2获取程序做什么拿到当前平台的可执行文件。怎么做从项目 Releases 页面下载对应压缩包win-x64 / mac-osx-x64 / linux-x64 各一个解压即得程序。Linux 和 macOS 首次运行前给文件加执行权限sudo chmod x ./feishu-doc-export应该看到什么目录里出现feishu-doc-export.exeWindows或无后缀的feishu-doc-exportLinux / macOS。卡点提示Windows 用户跳过 chmod 这一步即可。步骤 3运行第一条导出命令做什么把整个知识库导出为默认的 docx。怎么做知识库 ID 在飞书知识库地址栏space/后面即可看到./feishu-doc-export --appId你的AppId --appSecret你的AppSecret --spaceId知识库ID --exportPath/data/backup/feishu应该看到什么先打印正在加载知识库【XX】的所有文档信息随后逐篇输出正在导出文档——N.【文档名】跑完显示文档已全部导出、总耗时秒若有未导出的文档会编号列出清单。表格和多维表格自动落成 xlsx知识库里的 pdf、图片等文件类型也会一并下载。卡点提示不想记 spaceId 可以省略该参数程序会列出你有权限的知识库按提示输入序号即可。步骤 4换格式再导一次做什么按下游用途换导出格式。怎么做只改--saveType一个参数如--saveTypemd想导出个人空间文件夹则加--typecloudDoc --folderTokenxxx。应该看到什么md 文档和图片分别落在各自目录与images子目录文档内的图片引用自动改写为相对路径转换逻辑见src/feishu-doc-export/Helper/DocxToMdFormatHelper.cs。卡点提示建议每换一次格式就换一个空导出目录新旧文件不会互相覆盖。四、验证结果终端末尾出现文档已全部导出和总耗时且无法导出的文档清单为空或只剩已知问题文档。打开--exportPath指向的目录逐层对照飞书知识库的层级两边应一一对应路径还原逻辑见src/feishu-doc-export/DocumentPathGenerator.cs。抽查两个细节表格是否生成了 xlsx 文件md 文档里的图片是否都能打开。结果不对时第一步看终端末尾的失败清单和带【ERROR】标记的行单篇失败不会中断整个任务请求异常会自动重试至多 10 次清单里列了哪些文档没落盘、为什么照着补下即可。五、进阶组合月度自动备份写一个脚本配 crontab每月归档一份关键在--quit参数——没有它程序结束时会停在按任意键退出脚本会一直挂着。BACKUP_DIR/backup/feishu/$(date %Y-%m) mkdir -p $BACKUP_DIR ./feishu-doc-export --appId$APP_ID --appSecret$APP_SECRET --spaceId知识库ID \ --exportPath$BACKUP_DIR --saveTypepdf --quit接入 Git 做文档版本管理导出 md 到仓库目录后提交即可每次飞书大改版本地都留一份历史快照。./feishu-doc-export --appId$APP_ID --appSecret$APP_SECRET --spaceId知识库ID \ --saveTypemd --exportPath./docs --quit git add . git commit -m docs: 同步飞书文档备份六、避坑速查现象原因解决办法启动即提示指定的导出目录不存在程序要求导出目录预先存在不会自动创建先mkdir -p建好目录再运行报错无阅读或导出权限错误码 1069902应用云文档权限没开全或机器人未加入知识库管理员组或版本未上线核对权限分页项与管理员组配置确认版本已审核通过个别文档在末尾清单里标文件名超长文件名超过 64 字符超出系统命名限制在飞书里改名后重跑md 文件中引用块、表格、行内代码失真实现链路是官方接口下载 docx再转 markdowndocx 阶段已丢部分格式格式敏感的文档改用 docx 或 pdf 导出Linux / macOS 提示无法创建目录当前用户对导出目录无写权限用 sudo 运行或换一个可写目录Lark 国际版调用失败默认走飞书国内端点加参数--apiEndpointhttps://open.larksuite.com七、边界与说明Markdown 由 docx 二次转换引用块、表格、行内代码块可能失真对格式要求高的文档建议直接用 docx 或 pdf。个人空间云文档无法列出文件夹列表飞书对个人空间 API 有登录限制只能通过--folderToken指定文件夹逐个导出。工具只做读取与导出不会修改飞书里的任何内容文档直接落到本地磁盘AppSecret 仅在内存中用于换取访问令牌所有调用走飞书开放平台 HTTPS 接口。使用前确认你的账号对目标知识库有访问权限权限按最小化原则开通即可。写在最后一句话总结feishu-doc-export 把批量导出 还原目录 出错不中断三件事合成了一条命令。如果你的知识库有几十篇以上文档、或计划做定期备份和版本管理按本文 4 个步骤走30 分钟内可以拿到第一份完整备份如果只是偶尔导出一两篇手动下载更直接可以观望。【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考