飞书文档批量导出怎么做feishu-doc-export 一条命令备份整个知识库【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export周四晚上十点我对着飞书知识库里的 700 多个文档发呆公司要从飞书切换到企业微信一周内必须全部迁走。手动下载不现实于是我找到了开源项目 feishu-doc-export——一个专注飞书文档批量导出的工具一条命令就能把整个知识库同步到本地实测 700 文档仅需约 25 分钟。如果你也经历过类似的文档搬迁这篇文章就是为你准备的。我会从它为什么快讲起再带你走一遍完整的上手流程最后给出几个可以直接复用的业务场景和避坑要点。全程不堆代码只保留最关键、能直接跑的部分。一个真实场景700 多份文档要迁移我该怎么办先算一笔账。手动下载一个文档至少经历四步打开文档、点导出、选格式、找保存位置。按每个文档 2 分钟估算700 多个文档就是 24 小时左右的纯手工操作还得全程盯守。更糟的是目录结构会丢手动下载默认平铺在下载文件夹飞书里十几层的知识库层级要逐个手工重建表格容易乱版复制粘贴后表格、图片、排版全部走样中途断网就前功尽弃网线一拔进度归零只能从头再来市面上其实已有一些飞书文档导出工具但要么是网页版打包下载、量大时慢到像卡死要么一次只能导出一篇文档。feishu-doc-export 的作者正是在试了一圈都不顺手之后才决定自己动手——这也是这个项目最打动我的地方它解决的是每个人都可能遇到的真实痛点而不是为写而写的演示项目。先看结论同样的工作量时间差了多少对比项手动下载feishu-doc-export100 个文档耗时3~4 小时3~5 分钟700 文档耗时一整天起步约 25 分钟目录结构手工重建自动保持一致表格 / 多维表格易乱版自动导出为 xlsx中途异常前功尽弃单篇失败不影响整体参与程度全程盯守后台挂机可干别的根据项目实测数据700 个文档导出到本地总耗时约 25 分钟平均每秒约 0.5 个文档。这中间的差距不是快一点而是要不要加班的区别。三个设计细节决定了它为什么快飞书文档批量导出的难点从来不是下载一个文件而是大批量、保结构、不断档。这个工具的快藏在三个设计里直接走官方 API不模拟浏览器操作。程序通过飞书开放平台接口获取文档清单与下载地址异步批量拉取省掉了网页端反复跳转的开销。整个调用链token 获取、导出任务创建、结果轮询、文件下载封装在src/feishu-doc-export/HttpApi/目录中。递归还原目录树。知识库里的文档有父子层级程序先遍历全部节点再按父节点关系递归生成每篇文档的落盘路径见DocumentPathGenerator.cs导出的本地结构与飞书知识库一一对应迁移后无需二次整理。单文档失败不连坐。批量导出最怕一个报错拖垮全部。工具对每篇文档单独捕获异常失败的记入清单、最后统一打印其余文档照常下载文件名超长、格式不支持等问题文档也会被安全跳过而不是让整个任务崩溃。至于 Markdown 转换实现思路是先用飞书接口拿到 docx再基于 Aspose.Words 转成 md。把格式转换交给成熟库自己专注在调度与路径处理上这也是它跑得快的原因之一。从零到一飞书文档批量导出的完整上手流程整个流程我实际走了一遍大约 15 分钟能完成四个环节的耗时如下环节要做什么大约耗时创建自建应用在飞书开发者后台新建应用并开通权限5~8 分钟授权给知识库把应用机器人拉进知识库管理员组3~5 分钟下载程序按系统选择对应压缩包并解压1 分钟执行导出运行一条命令看文档量先拿钥匙申请 AppId 和 AppSecret打开飞书开发者后台创建一个企业自建应用基础信息随意填写。在权限管理里开通云文档相关的查看、下载与导出权限查看新版文档、导出云文档、查看和编辑知识库等。注意权限列表是分页的翻页确认不要漏项。在应用能力中添加机器人能力然后在版本管理与发布里创建版本并申请上线等待企业管理员审核。只想快速验证的话可以创建测试企业、绑定应用并切换到测试版本。在飞书客户端建一个群把自建应用作为群机器人添加进去接着打开目标知识库的知识空间设置→成员管理→添加管理员选择刚才的群。至此机器人就拥有了该知识库的访问权限。回到凭证与基础信息复制 App ID 和 App Secret这就是命令里要用的--appId与--appSecret。想导出个人空间云文档的话授权方式略有不同把要导出的文件夹分享给自建应用再从分享链接中提取folderToken备用。下载程序并跑通第一条命令按操作系统选择压缩包Windows 对应feishu-doc-export-win-x64.zipmacOS 与 Linux 分别对应-mac-osx-x64.zip和-linux-x64.zip。解压后 Windows 的可执行文件带.exe后缀另两个平台没有后缀。想自己编译源码的也可以先克隆仓库# 克隆源码可选多数用户直接下载 Release 更省事 git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-exportLinux / macOS 首次使用必须先授予执行权限# 赋予执行权限Linux / macOS 必做否则会报权限错误 sudo chmod x ./feishu-doc-export然后是真正的最小可运行示例——一条命令导出你所有可见的知识库# 最小示例导出全部知识库为 docx默认格式 ./feishu-doc-export --appId你的AppId --appSecret你的AppSecret --exportPath/home/backup/feishu运行后程序会自动列出你有权限的知识库输入序号回车即可开始。Windows 用户只需把路径换成E:\backup\feishu这样的盘符路径。导完去目标目录看一眼——层级结构和飞书里完全一致。三个贴近业务的真实场景工具的价值不止跑通一次下面三个场景是我觉得最实用的打开方式。场景一企业知识库整体搬迁把某个知识库完整导出到指定目录并按需选择格式# 指定知识库 ID 导出并保存为 Markdown适合迁移到新平台后二次加工 ./feishu-doc-export --appIdxxx --appSecretxxx --spaceId知识库ID --saveTypemd --exportPath/data/migrate/wiki表格和多维表格会自动落成 xlsx知识库里的 PDF、图片等文件类型也会一并下载几乎不需要二次补漏。场景二让备份像闹钟一样自动运行配合 cron 定时任务每月自动备份一次、按月份归档适合对文档安全敏感的团队#!/bin/bash # 每月备份脚本创建带年月标识的目录并执行导出 BACKUP_DIR/backup/feishu/$(date %Y-%m) mkdir -p $BACKUP_DIR ./feishu-doc-export --appId$APP_ID --appSecret$APP_SECRET \ --exportPath$BACKUP_DIR --saveTypepdf --quit注意这里的--quit参数它让程序导出结束后自动退出不会停在按任意键退出那一行是脚本化调用的关键。场景三把飞书文档纳入 Git 版本管理技术团队可以把导出的 Markdown 直接放进 Git 仓库实现文档的版本化与可追溯# 导出为 Markdown 到仓库目录然后提交 ./feishu-doc-export --appId$APP_ID --appSecret$APP_SECRET \ --saveTypemd --exportPath./docs git add . git commit -m docs: 同步飞书文档备份 git push origin main从此飞书里的每次大改版本地都留有历史快照。进阶玩法参数速查与优化建议所有命令行参数一次说清参数作用说明--appId/--appSecret应用凭证必填--exportPath导出目录必填--spaceId知识库 ID不填则列出全部知识库供选择--type导出对象wiki默认或cloudDoc--folderToken个人空间文件夹 Token--typecloudDoc时必填--saveType保存格式docx/md/pdf默认 docx--quit结束后自动退出适合脚本与定时任务--apiEndpoint指定 API 地址使用 Lark 国际版环境时配置性能方面根据项目实测与社区反馈docx 导出最快md 与 docx 速度接近pdf 最慢图片需要内嵌写入量更大实际速度还受网速、飞书服务器响应和磁盘写入速度影响。两个实用建议导出目录尽量放在 SSD 上超大知识库可以按子知识库分批导出方便逐批核对遗漏。高频问题与避坑清单❓导出时报权限错误九成是权限配置不完整要么应用权限没开全要么机器人没被加进知识库管理员组。按上文第 4 步重新核对并确认应用版本已审核上线测试环境记得切换到测试版本。❓Markdown 导出有格式丢失这是已知限制工具先下载 docx 再转 md引用块、表格、行内代码等语法在转换中可能失真转换逻辑见Helper/DocxToMdFormatHelper.cs。对格式要求高的文档直接用 docx 或 pdf 导出更稳妥。❓有些文档没导出来常见原因有两个文件名超过 64 个字符会被跳过系统命名限制改名后重跑即可个别类型不受支持则会在结尾统一列出清单手动补下就行。❓Linux / mac 报无法创建目录用sudo运行或确保导出目录对当前用户可写。❓知识库 ID 和 folderToken 去哪找知识库 ID 就在飞书知识库 URL 的space/后面个人空间文件夹 Token 在分享链接的folderToken参数里。安全与合规数据始终留在你自己的机器上飞书文档批量导出的全过程都在本地完成文档内容直接下载到你的磁盘App Secret 仅在内存中用于换取访问令牌不会被持久化存储所有 API 通信均走 HTTPS工具只做读取与导出不会修改飞书里的任何内容。合规层面它基于飞书官方开放平台开发使用前请确保你拥有对应知识库或文件夹的访问权限并遵守飞书开放平台的调用规范。权限遵循最小化原则给工具开通导出所需的必要权限即可。现在就动手给你的文档上个保险回到开头那个周四的夜晚——如果当时手边就有这个工具我只需要做三件事申请凭证、下载程序、跑一条命令然后在 25 分钟后拿到一个结构完整的本地知识库镜像。如今它已经从解决个人迁移痛点的应急脚本成长为一个支持三种导出格式、覆盖知识库与个人空间、可处理文件类型文档的成熟开源项目。如果你的飞书里也躺着成百上千个重要文档不妨现在就下载一份试试从最简单的导出命令开始。无论是企业迁移、定期备份还是文档版本管理把数据握在自己手里永远比依赖一个随时可能变化的在线平台更让人安心。【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考