飞书个人空间云文档也能批量导出：feishu-doc-export 指定文件夹迁移全攻略

飞书个人空间云文档也能批量导出feishu-doc-export 指定文件夹迁移全攻略【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export还在为飞书个人空间里的云文档发愁吗飞书文档导出工具 feishu-doc-export 不仅能一键导出整个知识库还支持个人空间云文档批量导出——你只需指定一个文件夹的 folderToken即可把该文件夹下的全部文档、表格、附件保持原目录结构下载到本地支持 docx、md、pdf 三种格式实测 700 多个文档仅需约 25 分钟。为什么个人空间文档导出这么难大多数飞书文档迁移工具只支持**知识库wiki**导出而个人空间云空间的文档却束手无策原因主要有两点登录限制飞书对个人空间做了登录限制未登录状态下个人空间相关的部分 API 无法直接调用而飞书只为网页端和小程序提供了登录接入方案命令行工具很难实现。无法列举文件夹正是受此限制该项目不支持自动列出你的文件夹列表必须手动提供一个folderToken来锁定要导出的文件夹。feishu-doc-export 的解决思路是通过自建应用 文件夹授权的方式获得导出权限再由你手动指定folderToken锁定目标文件夹从而绕开登录限制实现逻辑见src/feishu-doc-export/Program.cs中type cloudDoc分支约第 36~54 行。功能亮点一览 ⚡特性说明 支持平台Windows / macOS / Linux 三端通用.NET 单文件发布 导出格式docx最快、mdmarkdown、pdf 三种可选 目录结构与飞书原文件夹层级完全一致自动创建子目录 文档类型文档doc/docx→ docx表格/多维表格sheet/bitable→ xlsx普通附件直接下载 导出速度后台挂机运行实测 700 文档约 25 分钟 容错能力单篇文档异常自动跳过并记录保证整批导出不断线准备工作创建飞书自建应用进入飞书开发者后台创建一个企业自建应用信息随意填写。在「权限管理」中开通以下云文档相关权限注意有分页查看新版文档查看、评论和下载云空间中所有文件查看、评论和导出文档查看、评论、编辑和管理云空间中所有文件查看、评论、编辑和管理多维表格查看、编辑和管理知识库查看、评论、编辑和管理电子表格导出云文档在「添加应用能力」中添加机器人。创建一个版本并申请发布上线等企业管理员审核通过纯测试可先建测试企业。在「凭证与基础信息」中拿到App ID和App Secret这是后续命令行的必填参数。第一步把目标文件夹分享给自建应用 这是个人空间导出最关键的一步漏掉它会直接报权限错误打开飞书个人空间中要导出的文件夹。点击右上角「分享」把上面创建的自建应用添加为协作者。给应用授予「可编辑/可管理」级别权限确保它具备导出文档的能力。⚠️ 只有分享后的文件夹自建应用才能访问其中内容这是绕过飞书个人空间登录限制的前提。第二步获取文件夹的 folderTokenfolderToken 是飞书为每个文件夹生成的唯一标识获取方式很简单在飞书桌面端打开目标文件夹或右键文件夹查看链接。从地址栏 / 分享链接中提取folderToken参数的值形如一串字母数字组合。这个值稍后要填进命令行的--folderToken参数程序正是靠它锁定导出起点参数解析见src/feishu-doc-export/GlobalConfig.cs第 72~88 行的Init方法。第三步下载程序并执行导出命令 ️到仓库Releases页面下载最新版本按系统选择对应压缩包Windowsfeishu-doc-export-win-x64.zip可执行文件为feishu-doc-export.exemacOSfeishu-doc-export-mac-osx-x64.zipLinuxfeishu-doc-export-linux-x64.zip解压后在文件目录打开终端。macOS / Linux 首次使用需先授权可执行sudo chmod x ./feishu-doc-export执行导出命令个人空间云文档导出模板直接复制改参./feishu-doc-export --appId你的AppId --appSecret你的AppSecret \ --typecloudDoc --folderToken你的folderToken \ --saveTypemd --exportPath/home/feishu-documentWindows 下同理把--exportPath换成E:\temp\test这类本地路径即可。程序会先打印「正在加载个人空间云文档【文件夹名】文件夹下的所有文档信息」然后逐篇导出并显示进度编号最后汇总耗时和未能导出的文档清单见src/feishu-doc-export/Program.cs第 274~281 行的收尾输出逻辑。命令行参数速查表 参数必填说明--appId✅自建应用的 App ID--appSecret✅自建应用的 App Secret--exportPath✅文档导出的本地目录--type视情况cloudDoc个人空间或wiki知识库默认--folderToken视情况个人空间导出时必填文件夹唯一标识--spaceId否知识库导出时指定空间留空则交互选择--saveType否docx默认最快/md/pdf--apiEndpoint否Lark 国际版可指定为https://open.larksuite.com导出格式怎么选docx速度最快格式保真度最好日常迁移首选md先下载 docx 再转 Markdown适合做文档归档、进知识库或接 RAG/LLM 场景但会丢失部分引用语法、表格、行内代码块格式转换逻辑见src/feishu-doc-export/Helper/DocxToMdFormatHelper.cspdf图片内嵌体积最大、速度最慢适合存档打印。注意只有飞书**文档docx**类型才能应用--saveType表格始终导出为 xlsx附件保持原格式直接下载类型映射见src/feishu-doc-export/GlobalConfig.cs第 41~48 行的fileExtensionDict。导出效果目录结构完整保留 导出的本地目录与飞书文件夹层级一一对应文件名中的非法字符如\ / : * ? |会被自动替换为-见src/feishu-doc-export/CloudDocPathGenerator.cs第 32~44 行的递归路径生成逻辑。飞书文档中引用的同库文档还会改写为本地相对路径跨库引用则保留原文外链。常见问题 FAQ Q1报「请填写【folderToken】参数」--typecloudDoc时必须携带--folderToken两个参数是绑定关系。Q2导出中途某篇文档失败程序采用单篇容错策略失败文档自动跳过并记入结尾的清单不会中断整批任务失败文档按清单手动补下即可。Q3为什么不能自动列出我的个人文件夹飞书对个人空间有登录限制部分 API 未登录不可用且飞书未为服务端提供登录接入方案因此需要你手动提供 folderToken。Q4文件名太长导不出来超过 64 个字符的文件名会被自动跳过结尾清单标注「文件名超长」需手动处理。Q5想边下边看日志程序是纯后台运行不影响你正常工作想自动结束进程可加--quit参数执行完自动退出。写在最后 feishu-doc-export 用「自建应用 文件夹授权 指定 folderToken」三步就把飞书个人空间云文档的批量导出这个难题变得可落地一行命令、三种格式、目录结构原样保留。如果你正面临办公平台切换或文档归档不妨现在就试试。更多实现细节可参考src/feishu-doc-export/HttpApi/目录下的飞书开放平台调用封装以及项目根目录的readme.md。【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考