一条命令导出 700 个飞书文档还保住了目录结构【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-exportfeishu-doc-export 是一个开源的飞书文档批量导出工具只需一条命令就能把整个飞书知识库或个人空间云文档同步到本地支持 docx、markdown、pdf 三种格式。项目作者实测 700 多个文档全部导出只用 25 分钟程序全程后台挂机且本地目录结构与飞书里完全一致。这篇文章借一次真实的交接场景把如何从零开始用它完成飞书文档备份讲清楚。接手一个 700 篇文档的知识库是什么体验阿哲入职第三天前任把公司用了两年的飞书知识库交接给他只留下一句话这些文档帮我整理到本地后续要迁移。他打开知识库一看700 多个文档普通文档、表格、PDF 文件混在一起目录还分了七八层。他的第一反应是手动下载打开文档 → 点导出 → 选格式 → 选保存位置。一个文档顺利的话要两分钟700 个就是二十多个小时还得在本地手动重建目录结构想想就头大。于是他决定先找找现成方案。为什么现成的导出工具都不够顺手市面上不是没有飞书文档导出工具阿哲试了两类各有各的坑网页版打包下载把选中的文档在云端打包成一个压缩包再返回给你。他选了某个节点下 200 多个文档等了一个多小时还没好期间一旦断网或电脑重启前面的等待全部作废。命令行逐篇下载功能没问题但一次只能下载一个文档700 篇要手动执行 700 次同样不现实。而且这些方案大多不处理表格类型的文档目录结构也要自己重新搭。阿哲的诉求其实很朴素一次导出整个知识库、目录结构和飞书保持一致、速度别太慢。最后他在开源社区找到了 feishu-doc-export——一个基于 .NET 开发的跨平台命令行工具正好满足这几条。第一次运行前的三件准备第一步在飞书开发者后台建一个自建应用登录飞书开放平台创建企业自建应用然后在权限管理里开通云文档相关的查看与导出权限例如查看新版文档导出云文档查看、编辑和管理知识库等注意权限列表有分页别漏翻。接着给应用添加机器人能力发布一个版本并申请上线等待管理员审核通过。第二步把机器人加进知识库在飞书里建一个群把刚才的应用作为群机器人加进去然后在知识库的知识空间设置 → 成员管理 → 添加管理员里选择这个群。这一步很多人会漏掉漏了之后调用知识库接口会直接报权限错误。第三步找到凭证和知识库 IDAppId 和 AppSecret 在开发者后台的凭证与基础信息页面。知识库 ID 不用刻意记——打开知识库网页地址栏里space/后面那串就是更省事的做法是干脆不传这个参数让程序自己列出你能访问的知识库输入序号即可。真正跑起来其实就一条命令准备工作做完阿哲在终端里敲下了这行命令./feishu-doc-export \ --appId你的AppId \ --appSecret你的AppSecret \ --exportPath/home/arze/feishu-backup \ --saveTypedocxWindows 用户把可执行文件换成feishu-doc-export.exe参数完全一样。全部参数如下必填的只有三个参数作用是否必填--appId/--appSecret自建应用的凭证必填--exportPath文档保存到本地的目录必填--spaceId知识库 ID不传则列出所有知识库让你选选填--typewiki知识库或cloudDoc个人空间默认 wiki选填--saveTypedocx、md、pdf默认 docx选填--folderToken导出个人空间文档时必填选填第一次运行终端会先打印知识库列表输入序号后程序开始逐篇导出每篇文档的名字和进度实时滚动。阿哲这 700 多个文档docx 格式大约 25 分钟跑完具体耗时和网速、飞书服务器响应、磁盘写入速度都有关系期间他正常写代码完全不占手。除了快还有几个让人安心的细节用了一周之后阿哲发现这个工具真正值钱的地方不止是速度目录结构和飞书一致。知识库里怎么分层本地就怎么建目录迁移后不用重新整理。单个失败不拖垮整体。某篇文档导出异常会被跳过并记入日志全部跑完后程序会打印一份无法导出的文档清单你只需要针对清单手动补几篇。文档、表格、文件全覆盖。doc、docx、sheet、bitable 会转成对应格式知识库里的 PDF、图片等文件类型也会原样下载不会静默丢掉。网络抖动不恐慌。下载任务内置重试机制遇到请求异常会等待后自动重试而不是直接报错退出。想把个人空间也备份了怎么操作知识库之外个人空间云文档导出同样可行只是多一步授权先把想导出的文件夹分享给自建应用让应用获得读取权限然后在分享链接里找到folderToken后面的值命令行里这样跑./feishu-doc-export --appId你的AppId --appSecret你的AppSecret \ --typecloudDoc --folderToken你的文件夹Token \ --exportPath/home/arze/cloud-backup --saveTypemd有一点要提前知道飞书对个人空间有登录限制接口不支持直接列出文件夹列表所以必须手动指定--folderToken。这是平台限制不是工具偷懒。三种导出格式到底该选哪个--saveType有三个取值阿哲把三种都试了一遍结论很明确格式特点适合场景docx导出最快排版保留最好需要迁移或二次编辑的文档md便于纳入 Git 做版本管理技术文档、博客素材pdf最慢但呈现最接近原样图片内嵌存档、交付、对外分享需要提醒的是md 格式是由 docx 再转换而来的引用语法、表格、行内代码块等少数元素会有格式丢失。如果你要的是所见即所得的完整还原优先 docx 或 pdf。跑得更稳的几个小技巧阿哲把经验总结成四条新手可以直接照抄Linux/Mac 先加执行权限首次使用执行chmod x ./feishu-doc-export并建议用sudo运行避免导出目录没有写权限导致保存失败。文件名超过 64 字符会被跳过这类文档会在日志里列出事后手动下载即可。定时备份交给 cron把导出命令写进 crontab每月自动跑一次就能滚动留存一份文档备份。想深入看实现程序逻辑集中在 src/feishu-doc-export 下的 Program.cs、HttpApi 目录飞书接口封装和 Helper 目录格式转换与文件处理想改造成自己的工具从这三个目录入手最合适。给今晚就要动手的你阿哲的故事到这里就讲完了。如果你也面临类似处境——几百个飞书文档等着备份或迁移最省事的路径是这三步克隆仓库git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-export或从 Releases 页面下载对应系统的单文件版本花十分钟完成建应用、开权限、机器人进群这三件事粘贴上面那条命令回车然后去忙别的。等终端打印出文档已全部导出你低头看一眼本地目录——结构和飞书一模一样700 多个文档整整齐齐躺在那里。那个原本要花掉整个周末的活儿就这样被一条命令终结了。【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
