飞书文档批量导出feishu-doc-export 用一条命令备份整个知识库【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-exportfeishu-doc-export 是一个跨 Windows / macOS / Linux 的飞书文档批量导出工具一条命令即可把整个飞书知识库或个人云文档文件夹同步到本地支持 docx / md / pdf 三种格式。项目实测 700 多个文档约 25 分钟完成平均约 0.5 篇/秒。适合做飞书文档迁移、定期备份或把文档纳入版本管理流程的普通用户。先判断三个问题决定要不要用文档量是否到百级以上百级以下手动下载尚可接受上千文档时按每篇 2 分钟估算纯手工需要一整天以上自动导出才有收益。是否需要保留层级结构该工具按飞书知识库的父子关系递归还原目录落盘结构与线上一一对应只导一两篇平铺文档则用不上这个能力。凭证与权限是否可控制需要在飞书开发者后台创建企业自建应用并开通文档导出权限通常要管理员审核。如果拿不到应用凭证或知识库管理权限此方案不适用。三个问题都是肯定的再继续往下看。工作机制为什么大批量也能稳定跑完走官方 API不走浏览器模拟。程序通过飞书开放平台接口获取文档清单与下载地址异步批量拉取省掉网页端逐篇跳转的开销。整条调用链token 获取、导出任务创建、结果轮询、文件下载封装在 HttpApi 目录对使用者来说就是挂着跑。目录树递归还原。先遍历知识库全部节点再按父节点关系递归生成每篇文档的落盘路径实现见 DocumentPathGenerator.cs。导出完成后无需二次整理目录。失败隔离。每篇文档单独捕获异常单篇失败不中断整体失败与不支持的文档统一记入清单、结束时打印文件名超长等情况会被安全跳过而不是让整个任务崩溃。格式转换交给成熟库。md 导出先用官方接口下载 docx再基于 Aspose.Words 转 Markdown转换逻辑在 DocxToMdFormatHelper.cs。项目自身只专注调度与路径处理这也是速度稳定的原因之一。准备工作一飞书文档导出的凭证准备在飞书开发者后台创建企业自建应用。在权限管理开通云文档相关权限查看新版文档、查看/下载云空间文件、导出云文档、查看/编辑和管理知识库、电子表格与多维表格等。注意权限列表有分页逐项翻页确认。在应用能力中添加机器人创建版本并申请上线等待企业管理员审核。只做快速验证的话可创建测试企业并切换测试版本。准备工作二授权与 folderToken建一个飞书群把自建应用作为群机器人加进去。打开目标知识库知识空间设置 → 成员管理 → 添加管理员选择该群。机器人至此拥有知识库访问权限。回到凭证与基础信息记下App ID与App Secret即命令中的--appId与--appSecret。导出个人云文档时授权方式不同把目标文件夹分享给自建应用再从分享链接的folderToken参数提取值备用。执行飞书知识库导出的最短路按系统选包解压Windows 对应feishu-doc-export-win-x64.zipmacOS 对应feishu-doc-export-mac-osx-x64.zipLinux 对应feishu-doc-export-linux-x64.zipWindows 的可执行文件带.exe后缀另两个平台无后缀。想自己编译的可执行git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-export后自行构建。# Linux / macOS 首次使用先赋予执行权限再导出指定知识库为 Markdown sudo chmod x ./feishu-doc-export sudo ./feishu-doc-export --appId你的AppId --appSecret你的AppSecret \ --spaceId知识库ID --saveTypemd --exportPath/home/backup/feishuWindows 把命令换成feishu-doc-export.exe--exportPath用E:\backup\feishu这类盘符路径即可。--spaceId不传时程序会列出全部有权限的知识库输入序号回车即开始。知识库 ID 在飞书知识库 URL 的space/后面。配方三个高频配置按月定时备份目的备份像闹钟一样自动执行按月份归档。命令要点cron 创建带年月标识的目录并执行导出加--quit。#!/bin/bash # 每月备份导出为 pdf 并归档到当月目录--quit 保证导出后自动退出 mkdir -p /backup/feishu/$(date %Y-%m) ./feishu-doc-export --appId$APP_ID --appSecret$APP_SECRET \ --exportPath/backup/feishu/$(date %Y-%m) --saveTypepdf --quit注意--quit让程序结束后直接退出不停在等待按键的行是脚本化调用的关键。迁移到新平台的格式选择目的导出结果直接供新平台导入或二次加工。命令要点加--saveTypemd表格与多维表格自动落成 xlsx不受该参数影响。注意docx 最快md 与其接近pdf 因图片内嵌写入量大而最慢实际速度还受网速、服务端响应与磁盘影响导出目录建议放 SSD。把 md 接入检索或版本管理目的让导出的 Markdown 成为全文检索的语料或 Git 仓库里的版本化快照。命令要点加--saveTypemd指向仓库内的固定目录导出后提交即可。注意md 有已知格式损失见排坑第 2 条格式敏感的文档建议另跑一份 docx 或 pdf 兜底。参数速查参数含义什么时候用--appId自建应用的 App ID必填--appSecret自建应用的 App Secret必填--exportPath导出目录必填--spaceId知识库 ID不传则列出全部知识库供选择--type导出对象wiki默认或cloudDoc导出个人云文档时传cloudDoc--folderToken个人空间文件夹 Token--typecloudDoc时必填--saveType保存格式docx默认/md/pdf需要指定导出格式时--quit结束后自动退出cron 等脚本化调用--apiEndpoint指定 API 地址Lark 国际版环境如https://open.larksuite.com排坑记录现象执行时报权限错误。原因应用权限没开全或机器人所在群未被加进知识库管理员组或版本未审核上线。处理对照准备工作第 2 步逐项开通权限并检查分页确认应用版本已发布测试环境切换测试版本。现象Markdown 导出的引用块、表格、行内代码等语法失真。原因实现路径是先下载 docx 再转 mddocx 阶段已存在格式损失属已知限制。处理对格式要求高的文档改用--saveTypedocx或pdf。现象个别文档没导出来结尾清单里标注文件名超长。原因文档名超过 64 个字符触发系统文件命名限制后被跳过。处理在飞书里把该文档改短名后重新执行导出。现象Linux / macOS 报无法创建目录或权限不足。原因导出目录对当前用户不可写。处理换一个有写权限的路径或用sudo执行。现象不知道--spaceId和--folderToken从哪里取。原因两者都不在应用后台而在飞书客户端的链接里。处理知识库 ID 取知识库 URL 中space/后面的部分folderToken 取个人空间文件夹分享链接中folderToken后面的部分。权限与数据导出全程在本地执行文档直接写入--exportPath指定的目录。AppSecret 仅在内存中用于换取访问令牌不做持久化存储。所有 API 通信走 HTTPS。工具只读取和导出不改动飞书中的任何内容。开通权限遵循最小化原则文档导出相关即可。结尾feishu-doc-export 的适用边界很明确大批量、要保目录结构、需要可重复执行的飞书文档批量导出md 格式有已知损失排版敏感内容用 docx 或 pdf。准备好应用凭证后先用一条命令导出一个你最关心的知识库核对本地目录与线上结构一致再接入定期备份任务。【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
