一条命令搞定飞书文档批量导出700 文档 25 分钟同步本地全攻略【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-exportfeishu-doc-export 是一款基于 .NET Core 开发的飞书文档批量导出工具一条命令即可把整个知识库或个人空间云文档同步到本地支持 DOCX、Markdown、PDF 三种格式实测 700 文档仅需 25 分钟。接下来这份实操指南会带你从零跑通整套流程。一、那个让人崩溃的周五下午想象一个再普通不过的周五公司决定把协作工具从飞书切换到新的办公平台团队两年的沉淀——700 多份文档——需要尽快完成迁移。手动下载意味着什么每份文档都要打开 → 下载 → 选格式 → 找位置保存100 份就要耗掉大半天下载完的目录结构乱成一团迁移后还要花大量时间重新整理复制粘贴出来的文档排版错乱表格、图片面目全非网络一抖、电脑一重启前面全部白干 是不是很眼熟这正是很多团队面对飞书知识库迁移时的真实处境。与其硬扛不如把机械劳动交给程序。二、飞书文档批量导出的正确打开方式feishu-doc-export 要解决的正是上面那个场景。它是基于 .NET Core 的命令行工具Windows、Mac、Linux 都能跑通过飞书开放平台 API 读取文档列表后自动逐个导出本地目录结构与线上完全一致。对比项手动下载feishu-doc-export100 个文档耗时3 小时以上5 分钟左右目录结构混乱与知识库完全一致格式保持常丢失排版常规文档 95% 以上操作复杂度全程手工一条命令工具的用法很直接准备凭证 → 下载程序 → 执行命令三步即可完成第一次飞书文档导出。三、飞书文档备份的完整准备步骤第一次接触飞书开放平台的同学别被API吓到准备过程十分钟就能搞定。打开飞书开发者后台创建一个企业自建应用信息随意填写在权限管理里开通云文档相关权限重点是查看新版文档、查看/评论/导出文档、导出云文档、查看/编辑/管理知识库这几项在添加应用能力中给应用添加机器人创建版本并申请发布上线测试阶段可用测试企业快速通过审核建一个群组把应用机器人拉进去再把该群组设为知识库的管理员——这一步决定了机器人能否读到知识库内容回到凭证与基础信息页面复制App ID和App Secret这就是后面命令里的两把钥匙 想导出个人空间云文档还需要把目标文件夹分享给应用并从文件夹链接中取出folderToken。四、第一次飞书文档导出一行命令从下载到跑通按系统下载对应压缩包win-x64 / mac-osx-x64 / linux-x64解压即可得到可执行文件。Windows 下双击运行程序、跟着提示输入参数也能跑这里以命令行方式演示# Linux / Mac 首次使用需先赋予执行权限 sudo chmod x ./feishu-doc-export # 导出指定知识库默认保存为 docx 格式 sudo ./feishu-doc-export --appId你的AppId --appSecret你的AppSecret --spaceId知识库ID --exportPath/data/backup/feishu # 不传 spaceId 时程序会列出所有知识库交互式选择即可 sudo ./feishu-doc-export --appId你的AppId --appSecret你的AppSecret --exportPath/data/backup/feishuWindows 用户把命令前缀换成./feishu-doc-export.exe即可例如# Windows导出个人空间云文档并转成 Markdown ./feishu-doc-export.exe --appIdxxx --appSecretxxx --saveTypemd --exportPathE:\backup --typecloudDoc --folderTokenxxx几个常用参数说明--saveType可选docx、md、pdf默认 docx--type用于区分知识库wiki与个人空间cloudDoc--apiEndpoint可指定接口地址以适配 Lark 海外环境。想研究源码或自行编译的读者也可以克隆仓库git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-export。建议此处插入飞书文档导出命令执行过程与导出完成统计的示意图五、进阶玩法定时自动备份与 Markdown 入库飞书文档自动备份其实可以做到全无人值守。把命令写进 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技术团队还有另一个常用姿势把--saveTypemd的产物纳入 Git 仓库让文档随代码一起做版本管理改动有记录、回滚有依据# 导出为 Markdown 后提交到 Git形成文档版本管理闭环 git add . git commit -m docs: 同步飞书文档 $(date %Y-%m-%d) git push origin main至此飞书知识库迁移、定期备份、文档版本管理三个高频场景就全部覆盖了。六、数据与底气速度参考、稳定性与安全设计关于快用实测数据说话。工具采用 async/await 异步并发处理后台挂机运行不占用你的工作时间实测约 700 多个文档导出到本地总耗时 25 分钟。不同体量下的参考表现如下文档数量docx / mdpdf100 个3-5 分钟8-10 分钟500 个15-20 分钟30-35 分钟1000 个30-40 分钟60-70 分钟建议此处插入导出耗时统计截图可靠性上工具为单个文档的导出任务内置了多层重试与异常捕获单份文档失败会被记录并跳过不会中断整批任务结束时还会列出所有未能导出的文档清单方便你手动补漏。格式转换基于 Aspose.Words 引擎docx 与 md、pdf 之间互转稳定。安全性方面同样让人放心文档在本地处理后写入本地磁盘不会上传到任何第三方服务器凭证仅用于调用飞书 API接口全程走 HTTPS 加密同时建议遵循最小权限原则只给应用开通必要的读取与导出权限。换句话说飞书 API 导出文档这件事全程都在你的掌控之中。七、新手避坑指南权限、Token 与格式取舍把大家最容易踩的几个坑提前说清楚报权限错误多半是应用权限没开全或机器人还没被加进知识库管理员组确认应用已发布上线后再试。找不到 spaceId知识库页面 URL 中space/后面的那串字符就是也可以不传该参数让程序列出所有知识库供你选择。Markdown 有格式丢失飞书接口下载的 docx 本身就会丢失部分排版引用、表格、行内代码转 Markdown 时同样存在对格式要求高的文档建议直接导出 docx 或 pdf。个别文档被跳过程序支持常见文档类型文件类文档会直接下载原文件不支持的类型会提示你手动处理不会静默失败。写在最后700 多个文档、25 分钟、一条命令——这就是 feishu-doc-export 给出的答案。无论你是要一次性完成飞书知识库迁移还是想把飞书文档自动备份纳入日常运维它都能让你从繁琐的手动下载中彻底解放出来。现在就下载对应版本跑通你的第一条导出命令吧 【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 一条命令搞定飞书文档批量导出700 文档 25 分钟同步本地全攻略【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-exportfeishu-doc-export 是一款基于 .NET Core 开发的飞书文档批量导出工具一条命令即可把整个知识库或个人空间云文档同步到本地支持 DOCX、Markdown、PDF 三种格式实测 700 文档仅需 25 分钟。接下来这份实操指南会带你从零跑通整套流程。一、那个让人崩溃的周五下午想象一个再普通不过的周五公司决定把协作工具从飞书切换到新的办公平台团队两年的沉淀——700 多份文档——需要尽快完成迁移。手动下载意味着什么每份文档都要打开 → 下载 → 选格式 → 找位置保存100 份就要耗掉大半天下载完的目录结构乱成一团迁移后还要花大量时间重新整理复制粘贴出来的文档排版错乱表格、图片面目全非网络一抖、电脑一重启前面全部白干 是不是很眼熟这正是很多团队面对飞书知识库迁移时的真实处境。与其硬扛不如把机械劳动交给程序。二、飞书文档批量导出的正确打开方式feishu-doc-export 要解决的正是上面那个场景。它是基于 .NET Core 的命令行工具Windows、Mac、Linux 都能跑通过飞书开放平台 API 读取文档列表后自动逐个导出本地目录结构与线上完全一致。对比项手动下载feishu-doc-export100 个文档耗时3 小时以上5 分钟左右目录结构混乱与知识库完全一致格式保持常丢失排版常规文档 95% 以上操作复杂度全程手工一条命令工具的用法很直接准备凭证 → 下载程序 → 执行命令三步即可完成第一次飞书文档导出。三、飞书文档备份的完整准备步骤第一次接触飞书开放平台的同学别被API吓到准备过程十分钟就能搞定。打开飞书开发者后台创建一个企业自建应用信息随意填写在权限管理里开通云文档相关权限重点是查看新版文档、查看/评论/导出文档、导出云文档、查看/编辑/管理知识库这几项在添加应用能力中给应用添加机器人创建版本并申请发布上线测试阶段可用测试企业快速通过审核建一个群组把应用机器人拉进去再把该群组设为知识库的管理员——这一步决定了机器人能否读到知识库内容回到凭证与基础信息页面复制App ID和App Secret这就是后面命令里的两把钥匙 想导出个人空间云文档还需要把目标文件夹分享给应用并从文件夹链接中取出folderToken。四、第一次飞书文档导出一行命令从下载到跑通按系统下载对应压缩包win-x64 / mac-osx-x64 / linux-x64解压即可得到可执行文件。Windows 下双击运行程序、跟着提示输入参数也能跑这里以命令行方式演示# Linux / Mac 首次使用需先赋予执行权限 sudo chmod x ./feishu-doc-export # 导出指定知识库默认保存为 docx 格式 sudo ./feishu-doc-export --appId你的AppId --appSecret你的AppSecret --spaceId知识库ID --exportPath/data/backup/feishu # 不传 spaceId 时程序会列出所有知识库交互式选择即可 sudo ./feishu-doc-export --appId你的AppId --appSecret你的AppSecret --exportPath/data/backup/feishuWindows 用户把命令前缀换成./feishu-doc-export.exe即可例如# Windows导出个人空间云文档并转成 Markdown ./feishu-doc-export.exe --appIdxxx --appSecretxxx --saveTypemd --exportPathE:\backup --typecloudDoc --folderTokenxxx几个常用参数说明--saveType可选docx、md、pdf默认 docx--type用于区分知识库wiki与个人空间cloudDoc--apiEndpoint可指定接口地址以适配 Lark 海外环境。想研究源码或自行编译的读者也可以克隆仓库git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-export。建议此处插入飞书文档导出命令执行过程与导出完成统计的示意图五、进阶玩法定时自动备份与 Markdown 入库飞书文档自动备份其实可以做到全无人值守。把命令写进 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技术团队还有另一个常用姿势把--saveTypemd的产物纳入 Git 仓库让文档随代码一起做版本管理改动有记录、回滚有依据# 导出为 Markdown 后提交到 Git形成文档版本管理闭环 git add . git commit -m docs: 同步飞书文档 $(date %Y-%m-%d) git push origin main至此飞书知识库迁移、定期备份、文档版本管理三个高频场景就全部覆盖了。六、数据与底气速度参考、稳定性与安全设计关于快用实测数据说话。工具采用 async/await 异步并发处理后台挂机运行不占用你的工作时间实测约 700 多个文档导出到本地总耗时 25 分钟。不同体量下的参考表现如下文档数量docx / mdpdf100 个3-5 分钟8-10 分钟500 个15-20 分钟30-35 分钟1000 个30-40 分钟60-70 分钟建议此处插入导出耗时统计截图可靠性上工具为单个文档的导出任务内置了多层重试与异常捕获单份文档失败会被记录并跳过不会中断整批任务结束时还会列出所有未能导出的文档清单方便你手动补漏。格式转换基于 Aspose.Words 引擎docx 与 md、pdf 之间互转稳定。安全性方面同样让人放心文档在本地处理后写入本地磁盘不会上传到任何第三方服务器凭证仅用于调用飞书 API接口全程走 HTTPS 加密同时建议遵循最小权限原则只给应用开通必要的读取与导出权限。换句话说飞书 API 导出文档这件事全程都在你的掌控之中。七、新手避坑指南权限、Token 与格式取舍把大家最容易踩的几个坑提前说清楚报权限错误多半是应用权限没开全或机器人还没被加进知识库管理员组确认应用已发布上线后再试。找不到 spaceId知识库页面 URL 中space/后面的那串字符就是也可以不传该参数让程序列出所有知识库供你选择。Markdown 有格式丢失飞书接口下载的 docx 本身就会丢失部分排版引用、表格、行内代码转 Markdown 时同样存在对格式要求高的文档建议直接导出 docx 或 pdf。个别文档被跳过程序支持常见文档类型文件类文档会直接下载原文件不支持的类型会提示你手动处理不会静默失败。写在最后700 多个文档、25 分钟、一条命令——这就是 feishu-doc-export 给出的答案。无论你是要一次性完成飞书知识库迁移还是想把飞书文档自动备份纳入日常运维它都能让你从繁琐的手动下载中彻底解放出来。现在就下载对应版本跑通你的第一条导出命令吧 【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
