飞书文档导出终极指南：3步实现全自动备份
【免费下载链接】feishu-doc-export项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export
还在为飞书文档迁移而烦恼吗？feishu-doc-export 开源工具帮你一键解决文档导出难题，只需简单配置就能将飞书知识库完美备份到本地电脑，支持Markdown、DOCX、PDF三种格式，完整保留原目录结构。
🎯 为什么选择这个工具？
| 传统方法痛点 | feishu-doc-export 解决方案 |
|---|---|
| ❌ 手动下载耗时耗力 | ✅ 25分钟自动完成700份文档 |
| ❌ 文件夹结构混乱 | ✅ 完美复刻飞书目录层级 |
| ❌ 表格文档无法导出 | ✅ 支持文档表格全类型导出 |
| ❌ 网络中断重头再来 | ✅ 断点续传不怕意外中断 |
🚀 快速开始教程
第一步：获取飞书应用凭证
关键权限配置：
- 查看新版文档权限
- 云空间文件访问权限
- 导出云文档权限
- 知识库管理权限
第二步：下载工具并配置
系统版本选择：
- Windows：feishu-doc-export-win-x64.zip
- Mac：feishu-doc-export-mac-osx-x64.zip
- Linux：feishu-doc-export-linux-x64.zip
配置要点：
- 解压到英文路径文件夹
- Mac/Linux用户需授权执行权限
- 建议路径示例：
D:\tools\feishu-export
第三步：执行导出命令
基础命令格式：
./feishu-doc-export --appId=你的AppID --appSecret=你的密钥 --exportPath=导出目录 --saveType=格式实用命令示例：
# 导出Markdown格式 ./feishu-doc-export --appId=cli_xxx --appSecret=xxx --exportPath=/home/docs --saveType=md # 导出DOCX格式（推荐首次使用） ./feishu-doc-export --appId=cli_xxx --appSecret=xxx --exportPath=D:\backup --saveType=docx📊 导出格式性能对比
| 格式类型 | 导出速度 | 文件体积 | 格式完整性 | 推荐场景 |
|---|---|---|---|---|
| DOCX | ⭐⭐⭐⭐⭐ | 较大 | 完美保留 | 文档迁移、格式要求高 |
| Markdown | ⭐⭐⭐⭐ | 较小 | 良好支持 | 技术文档、版本管理 |
| ⭐⭐⭐ | 最大 | 固定格式 | 正式归档、打印分享 |
🔧 进阶使用技巧
个人空间文档导出
使用--type=cloudDoc参数导出个人空间文档：
./feishu-doc-export --appId=xxx --appSecret=xxx --type=cloudDoc --folderToken=文件夹标识 --exportPath=导出路径获取folderToken方法：
- 在飞书打开目标文件夹
- 点击分享按钮
- 从分享链接复制
folder_token参数
定时自动备份方案
Linux用户可使用crontab设置定时任务：
# 每天凌晨2点自动备份 0 2 * * * cd /home/tools/feishu-export && ./feishu-doc-export --appId=xxx --appSecret=xxx --exportPath=/backup/feishu⚠️ 常见问题解决
权限配置问题：
- 确保开通全部云文档权限
- 注意权限页面可能有分页需要翻页查看
Mac用户执行失败：
- 必须通过终端执行命令
- 不要直接双击运行
路径相关问题：
- 使用纯英文路径避免兼容问题
- 不要包含中文或特殊字符
💡 最佳实践建议
- 首次使用选择DOCX格式- 确保格式完整性最佳
- 批量导出选择非工作时间- 避免影响网络速度
- 定期更新工具版本- 获取最新功能支持
- 重要文档双重备份- 使用不同格式保存
现在你已经掌握了飞书文档一键导出的全部技巧！这个开源工具就像你的"智能文档管家"，让繁琐的导出工作变得轻松高效。无论是团队协作文档迁移还是个人资料备份，都能完美胜任。
核心源码参考：src/feishu-doc-export/ 配置帮助文档：src/feishu-doc-export/readme.md
【免费下载链接】feishu-doc-export项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
