飞书知识库文档导出新手教程feishu-doc-export 5 分钟快速上手完整指南【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export如果你正在找飞书文档导出工具feishu-doc-export 是一个值得收藏的开源项目仅需一行命令就能把飞书知识库的全部文档含表格、附件批量导出为markdown、docx、pdf三种格式并完整保留原有目录结构。本文面向新手带你 5 分钟完成从获取凭证到导出成功的全过程。一、它是什么适合谁用飞书文档导出服务 feishu-doc-export 基于 .NET 跨平台开发支持Windows / macOS / Linux三大系统核心能力如下整库导出一次导出知识库下的所有文档含文档、表格sheet/bitable、PDF、图片等附件目录还原本地导出的目录结构与飞书知识库完全一致由 DocumentPathGenerator.cs 递归生成三格式支持docx默认、md、pdf通过--saveType参数切换⚡后台挂机实测 700 文档导出仅需 25 分钟过程不阻塞正常工作断点容错单个文档失败自动跳过并汇总提示整体任务不中断二、导出前准备获取 AppId 与 AppSecret程序通过飞书开放平台 API 工作因此需要先创建一个企业自建应用。1. 创建应用并开通权限进入飞书开发者后台创建企业自建应用信息随意填写打开权限管理开通以下云文档权限注意有分页别漏查看新版文档查看、评论和下载云空间中所有文件查看、评论和导出文档查看、评论、编辑和管理云空间中所有文件查看、评论、编辑和管理多维表格查看、编辑和管理知识库查看、评论、编辑和管理电子表格导出云文档添加应用能力添加机器人在版本管理与发布中创建一个版本并申请发布等待企业管理员审核纯测试可创建测试企业绑定应用后切换测试版本回到凭证与基础信息页面复制App ID和App Secret2. 让机器人进入知识库新建或复用一个飞书群把刚创建的应用添加为群机器人打开目标知识库 →知识空间设置 → 成员管理 → 添加管理员选择这个群小技巧知识库 IDspaceId可在知识库设置页面的 URL 中找到。不填spaceId时程序会列出你有权限的所有知识库让你选。三、5 分钟快速上手下载程序并执行导出命令第 1 步下载程序包到项目的 Releases 发布页选择最新版本下载对应你系统的压缩包操作系统下载包可执行文件Windows x64feishu-doc-export-win-x64.zipfeishu-doc-export.exemacOS x64feishu-doc-export-mac-osx-x64.zipfeishu-doc-exportLinux x64feishu-doc-export-linux-x64.zipfeishu-doc-export解压后直接运行即可无需安装任何依赖。如果你是开发者想阅读源码可执行git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-export第 2 步在可执行文件目录打开终端执行命令# Windows导出指定知识库默认 docx 格式 ./feishu-doc-export.exe --appId111111 --appSecret2222222 --spaceId333333 --exportPathE:\temp\test# Linux / macOS首次使用先授权执行 sudo chmod x ./feishu-doc-export # 不指定知识库导出为 markdown sudo ./feishu-doc-export --appIdxxx --appSecretxxx --saveTypemd --exportPath/home/feishu-document执行后程序会显示正在加载知识库【xxx】的所有文档信息随后逐篇输出导出进度完成后自动汇总无法导出的文档清单和总耗时。第 3 步核对本地目录打开导出目录exportPath你会发现文件夹层级与飞书知识库一一对应文档、表格、附件各就各位。四、命令行参数速查表所有参数在 GlobalConfig.cs 中有完整说明参数必填说明--appId✅飞书自建应用的 AppId--appSecret✅飞书自建应用的 AppSecret--exportPath✅文档导出的本地目录需已存在--spaceId⬜知识库 ID不传则交互式选择--type⬜wiki知识库默认或cloudDoc个人空间云文档--saveType⬜导出格式docx默认/md/pdf--folderToken⬜typecloudDoc时必填文件夹 Token--apiEndpoint⬜自定义 API 域名如 Lark 环境--quit⬜执行结束后自动退出无需按键五、进阶场景导出个人空间云文档个人空间文档属于你的私有云空间导出方式稍有不同在飞书中将待导出文件夹分享给自建应用授予其文档导出权限打开文件夹后从 URL 中复制folderToken执行命令./feishu-doc-export.exe --appIdxxx --appSecretxxx --saveTypemd --typecloudDoc --folderTokenxxx --exportPathE:\temp\test相关流程实现在 Program.cs 中。⚠️ 注意飞书对个人空间做了登录限制未登录状态下相关 API 不可用因此程序暂不支持列出所有个人空间文件夹需要你手动提供folderToken。六、格式怎么选docx / md / pdf 对比格式速度适用场景注意事项docx最快需要保留版式、二次编辑推荐默认选择md中等接入 Git 仓库、知识库迁移由 docx 转 md引用语法、表格、行内代码块可能丢失文档内图片会自动存入同级images目录并改写为相对路径pdf最慢归档、打印图片为内嵌式导出耗时最长Markdown 转换逻辑位于 DocxToMdFormatHelper.cs引用文档的处理很贴心知识库内互相引用的文档会改写为本地相对路径外链则保持原样。七、新手常见问题 FAQQ1提示参数不能为空或没有找到参数三个必填项--appId、--appSecret、--exportPath缺一不可且参数值不能为空。Q2Linux/mac 下提示权限不足执行前运行sudo chmod x ./feishu-doc-export并用sudo启动否则保存文档时可能无法创建目录。Q3部分文档没导出来程序结束时会自动列出不支持导出/导出异常的文档清单超长文件名、未知类型等按清单手动下载即可其余文档不受影响。Q4想批量挂机跑完自动关闭终端追加--quit参数执行完成后程序自动退出无需按键。八、项目结构一览给想深入的同学模块文件说明程序入口Program.cs知识库/个人空间两条导出主流程参数解析GlobalConfig.cs命令行参数与交互输入两种方式飞书 APIIFeiShuHttpApi.cs知识库、导出任务、文件下载接口定义Token 管理FeiShuTokenProvider.cs自动获取与刷新 tenant_access_token路径生成DocumentPathGenerator.cs递归重建知识库目录结构格式转换DocxToMdFormatHelper.csdocx → markdown 图片/引用路径改写九、总结feishu-doc-export 用一行命令解决了飞书文档批量迁移的痛点权限配置一次之后无论是整库备份、换平台迁移还是归档留痕只需一条命令即可在后台静默完成。对于文档量数百上千的团队它比手动下载高效一个量级。 新手行动清单① 创建自建应用并开通云文档权限 → ② 把机器人拉进知识库管理员 → ③ 下载对应系统的程序包 → ④ 执行导出命令 → ⑤ 核对本地目录。按这个顺序操作5 分钟内你就能收获第一份完整的飞书文档导出成果。【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考