飞书文档批量导出实操指南把整个知识库搬回本地一条命令就够了【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export周五下午组长丢来一句话下周一之前把这三年攒下的知识库全部备份到本地。我盯着后台里一千多个文档脑子一片空白。后来是开源的飞书文档批量导出工具 feishu-doc-export 救了我——这个基于 .NET Core 的命令行工具同时支持 Windows / Mac / Linux能把知识库和个人空间里的文档成批拉回本地输出 DOCX、Markdown、PDF 三种格式实测 700 多个文档只需 25 分钟左右。今天就把这套完整流程分享给你。手动下载的账算一笔就心疼先别急着上工具我们来看看人肉下载究竟要付出什么代价。假设每个文档都要走完打开→点击下载→选择格式→指定保存位置这四步按平均 2 分钟一个算100 个文档3 小时起步中途还得祈祷网络稳定、手不滑下载完的目录结构彻底乱套原有文件夹层级荡然无存回头整理又是半天靠复制粘贴应急的话表格、图片、排版基本是薛定谔的格式——看着在用起来就没了万一断网断电前面全部白干心态直接爆炸。手动与工具之间的差距看这张表就懂了对比项手动下载feishu-doc-export100 个文档耗时3-4 小时5-8 分钟目录结构完全打乱保持原样格式保留部分丢失95% 以上操作复杂度反复重复劳动一条命令说白了手动方式适合偶尔存几个量级一上百就是纯纯的内耗。它凭什么能扛住批量任务feishu-doc-export 走的是飞书开放平台的官方 API因此知识库wiki和个人空间云文档都能统一纳管。项目结构规整核心目录各司其职HttpApi 目录封装了所有文档相关接口负责与云端打交道Helper 目录承担格式转换与内容解析入口程序处理本地文件的创建与落盘CustomException.cs 则负责兜住各种异常保证单个文档失败不影响整个批次。运行机制上也有讲究任务用 async/await 异步模型并发处理不会傻等一个个排队格式转换基于 Aspose.Words 引擎DOCX、PDF、Markdown 之间可以互转再加上多层级错误捕获与恢复机制跑大批量任务时哪怕个别文档报错整体流程也不会中断。可以说它代码不复杂但跑得动、也跑得稳。准备钥匙拿到 API 凭证的四个动作工欲善其事必先利其器。使用前需要去飞书开放平台做一次应用注册进入飞书开发者后台创建一个企业自建应用在权限管理里勾选文档相关权限重点包括查看新版文档、查看并下载云空间文件、查看评论和导出文档、导出云文档以及知识库的查看与编辑管理在凭证与基础信息页面抄下 App ID 和 App Secret这两串字符就是后面命令里的钥匙把应用的机器人拉进目标知识库的管理员组否则会被权限卡住。做完这四步你的命令参数就齐了。一条命令跑通批量导出的写法获取工具有两种方式克隆源码或者从 Release 页面下载对应平台的预编译版本Windows 是 win-x64Mac 是 mac-osx-x64Linux 是 linux-x64。# 克隆项目源码 git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-export接着是最核心的一条命令三个必填参数缺一不可# 把整个空间导出到本地备份目录 ./feishu-doc-export \ --appId你的AppId \ --appSecret你的AppSecret \ --exportPath/home/文档备份Windows 上把程序换成 exe、路径换成盘符写法即可。想限定知识库、指定格式再追加两个可选参数# 只导某个知识库输出为 docx ./feishu-doc-export --appIdxxx --appSecretxxx \ --spaceId知识库ID --exportPath/backup/doc --saveTypedocx到这里你的第一次飞书文档批量导出其实已经完成了。进阶玩法三个真实场景场景一企业知识库整体迁移公司要从飞书迁到别的平台时最怕内容七零八落。用工具一把梭25 分钟交付# 导出整个知识库到迁移目录 ./feishu-doc-export --appId企业AppId --appSecret企业AppSecret \ --spaceId知识库ID --exportPath/迁移备份 --saveTypedocx对比一下传统方案 3 个人手动搬两天格式还丢得厉害现在一条命令 25 分钟格式完整度 95% 以上高下立判。场景二cron 定时自动备份把命令写进 crontab每月自动跑一次云端文档就永远有双保险#!/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 find /backup/feishu -type d -mtime 90 -exec rm -rf {} \;场景三Markdown 进 Git文档版本化技术团队可以把导出的 md 文件纳入 Git 仓库每次更新都有迹可循# 导出成 md 到 docs 目录然后提交 ./feishu-doc-export --appId$APP_ID --appSecret$APP_SECRET \ --saveTypemd --exportPath./docs git add . git commit -m docs: 更新飞书文档备份 $(date %Y-%m-%d) git push origin main性能到底怎么样空口无凭看一组实测数据单位分钟文档数量DOCXMarkdownPDF内存占用100 个3-53-58-10 100MB500 个15-2015-2030-35 150MB1000 个30-4030-4060-70 200MB想跑得更快几个小建议优先在有线网络下批量执行避开晚高峰时段落盘位置选 SSD超大型知识库可以按 spaceId 分批导出避免单次任务过重。避坑指南常见问题一次说清Q1一跑就报权限错误多半是应用权限没配全。逐项检查权限是否开通、机器人是否已加入知识库管理员组、App ID / Secret 有没有抄错、应用版本是否已正式发布上线。Q2知识库 ID 和文件夹 Token 怎么拿知识库 ID 藏在 URL 里——打开知识库页面space/后面那串字符串就是个人空间的文件夹右键获取链接folderToken后面的值即为 Token。Q3Markdown 导出后部分格式丢了飞书 API 返回的数据与 Markdown 语法并非完全兼容这是平台层面的限制。要还原度就选 DOCX复杂表格和特殊排版选 PDF必要时再做二次转换补救。Q4能导哪些类型的文档普通文档、表格文档、文件型文档PDF、图片等、知识库文档、个人空间云文档基本都能覆盖。数据和凭证安全吗安全这块可以放心设计上有多道锁所有处理都在本地完成内容不会上传到任何第三方服务器App ID 和 App Secret 只用于 API 调用不做持久化存储建议只授予必要的读取权限遵循最小授权原则全部 API 通信走 HTTPS 加密传输。同时工具完全基于飞书官方开放平台开发遵守其服务条款尊重文档版权与访问权限并保留操作日志属于合规使用。下一步动手吧从拿到凭证到跑通第一条命令全程不超过十分钟而它替你省下的是成百上千次重复点击。如果你正面临飞书文档批量导出、知识库备份或迁移的需求现在就可以克隆或下载 feishu-doc-export按上文拿到 App ID 与 App Secret运行第一条导出命令把文档搬回家。无论你是要整体迁移知识库、定时做备份还是把文档交给 Git 管理这条命令都值得你今晚就试一次。剩下的交给工具去跑就好。【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 飞书文档批量导出实操指南：把整个知识库搬回本地，一条命令就够了
飞书文档批量导出实操指南把整个知识库搬回本地一条命令就够了【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export周五下午组长丢来一句话下周一之前把这三年攒下的知识库全部备份到本地。我盯着后台里一千多个文档脑子一片空白。后来是开源的飞书文档批量导出工具 feishu-doc-export 救了我——这个基于 .NET Core 的命令行工具同时支持 Windows / Mac / Linux能把知识库和个人空间里的文档成批拉回本地输出 DOCX、Markdown、PDF 三种格式实测 700 多个文档只需 25 分钟左右。今天就把这套完整流程分享给你。手动下载的账算一笔就心疼先别急着上工具我们来看看人肉下载究竟要付出什么代价。假设每个文档都要走完打开→点击下载→选择格式→指定保存位置这四步按平均 2 分钟一个算100 个文档3 小时起步中途还得祈祷网络稳定、手不滑下载完的目录结构彻底乱套原有文件夹层级荡然无存回头整理又是半天靠复制粘贴应急的话表格、图片、排版基本是薛定谔的格式——看着在用起来就没了万一断网断电前面全部白干心态直接爆炸。手动与工具之间的差距看这张表就懂了对比项手动下载feishu-doc-export100 个文档耗时3-4 小时5-8 分钟目录结构完全打乱保持原样格式保留部分丢失95% 以上操作复杂度反复重复劳动一条命令说白了手动方式适合偶尔存几个量级一上百就是纯纯的内耗。它凭什么能扛住批量任务feishu-doc-export 走的是飞书开放平台的官方 API因此知识库wiki和个人空间云文档都能统一纳管。项目结构规整核心目录各司其职HttpApi 目录封装了所有文档相关接口负责与云端打交道Helper 目录承担格式转换与内容解析入口程序处理本地文件的创建与落盘CustomException.cs 则负责兜住各种异常保证单个文档失败不影响整个批次。运行机制上也有讲究任务用 async/await 异步模型并发处理不会傻等一个个排队格式转换基于 Aspose.Words 引擎DOCX、PDF、Markdown 之间可以互转再加上多层级错误捕获与恢复机制跑大批量任务时哪怕个别文档报错整体流程也不会中断。可以说它代码不复杂但跑得动、也跑得稳。准备钥匙拿到 API 凭证的四个动作工欲善其事必先利其器。使用前需要去飞书开放平台做一次应用注册进入飞书开发者后台创建一个企业自建应用在权限管理里勾选文档相关权限重点包括查看新版文档、查看并下载云空间文件、查看评论和导出文档、导出云文档以及知识库的查看与编辑管理在凭证与基础信息页面抄下 App ID 和 App Secret这两串字符就是后面命令里的钥匙把应用的机器人拉进目标知识库的管理员组否则会被权限卡住。做完这四步你的命令参数就齐了。一条命令跑通批量导出的写法获取工具有两种方式克隆源码或者从 Release 页面下载对应平台的预编译版本Windows 是 win-x64Mac 是 mac-osx-x64Linux 是 linux-x64。# 克隆项目源码 git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-export接着是最核心的一条命令三个必填参数缺一不可# 把整个空间导出到本地备份目录 ./feishu-doc-export \ --appId你的AppId \ --appSecret你的AppSecret \ --exportPath/home/文档备份Windows 上把程序换成 exe、路径换成盘符写法即可。想限定知识库、指定格式再追加两个可选参数# 只导某个知识库输出为 docx ./feishu-doc-export --appIdxxx --appSecretxxx \ --spaceId知识库ID --exportPath/backup/doc --saveTypedocx到这里你的第一次飞书文档批量导出其实已经完成了。进阶玩法三个真实场景场景一企业知识库整体迁移公司要从飞书迁到别的平台时最怕内容七零八落。用工具一把梭25 分钟交付# 导出整个知识库到迁移目录 ./feishu-doc-export --appId企业AppId --appSecret企业AppSecret \ --spaceId知识库ID --exportPath/迁移备份 --saveTypedocx对比一下传统方案 3 个人手动搬两天格式还丢得厉害现在一条命令 25 分钟格式完整度 95% 以上高下立判。场景二cron 定时自动备份把命令写进 crontab每月自动跑一次云端文档就永远有双保险#!/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 find /backup/feishu -type d -mtime 90 -exec rm -rf {} \;场景三Markdown 进 Git文档版本化技术团队可以把导出的 md 文件纳入 Git 仓库每次更新都有迹可循# 导出成 md 到 docs 目录然后提交 ./feishu-doc-export --appId$APP_ID --appSecret$APP_SECRET \ --saveTypemd --exportPath./docs git add . git commit -m docs: 更新飞书文档备份 $(date %Y-%m-%d) git push origin main性能到底怎么样空口无凭看一组实测数据单位分钟文档数量DOCXMarkdownPDF内存占用100 个3-53-58-10 100MB500 个15-2015-2030-35 150MB1000 个30-4030-4060-70 200MB想跑得更快几个小建议优先在有线网络下批量执行避开晚高峰时段落盘位置选 SSD超大型知识库可以按 spaceId 分批导出避免单次任务过重。避坑指南常见问题一次说清Q1一跑就报权限错误多半是应用权限没配全。逐项检查权限是否开通、机器人是否已加入知识库管理员组、App ID / Secret 有没有抄错、应用版本是否已正式发布上线。Q2知识库 ID 和文件夹 Token 怎么拿知识库 ID 藏在 URL 里——打开知识库页面space/后面那串字符串就是个人空间的文件夹右键获取链接folderToken后面的值即为 Token。Q3Markdown 导出后部分格式丢了飞书 API 返回的数据与 Markdown 语法并非完全兼容这是平台层面的限制。要还原度就选 DOCX复杂表格和特殊排版选 PDF必要时再做二次转换补救。Q4能导哪些类型的文档普通文档、表格文档、文件型文档PDF、图片等、知识库文档、个人空间云文档基本都能覆盖。数据和凭证安全吗安全这块可以放心设计上有多道锁所有处理都在本地完成内容不会上传到任何第三方服务器App ID 和 App Secret 只用于 API 调用不做持久化存储建议只授予必要的读取权限遵循最小授权原则全部 API 通信走 HTTPS 加密传输。同时工具完全基于飞书官方开放平台开发遵守其服务条款尊重文档版权与访问权限并保留操作日志属于合规使用。下一步动手吧从拿到凭证到跑通第一条命令全程不超过十分钟而它替你省下的是成百上千次重复点击。如果你正面临飞书文档批量导出、知识库备份或迁移的需求现在就可以克隆或下载 feishu-doc-export按上文拿到 App ID 与 App Secret运行第一条导出命令把文档搬回家。无论你是要整体迁移知识库、定时做备份还是把文档交给 Git 管理这条命令都值得你今晚就试一次。剩下的交给工具去跑就好。【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考