企业官网建设流程全解析

飞书文档导出终极指南：3步实现全自动备份

【免费下载链接】feishu-doc-export项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export

还在为飞书文档迁移而烦恼吗？feishu-doc-export 开源工具帮你一键解决文档导出难题，只需简单配置就能将飞书知识库完美备份到本地电脑，支持Markdown、DOCX、PDF三种格式，完整保留原目录结构。

🎯 为什么选择这个工具？

🚀 快速开始教程

第一步：获取飞书应用凭证

关键权限配置：

• 查看新版文档权限
• 云空间文件访问权限
• 导出云文档权限
• 知识库管理权限

第二步：下载工具并配置

系统版本选择：

• 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

📊 导出格式性能对比

🔧 进阶使用技巧

个人空间文档导出

使用--type=cloudDoc参数导出个人空间文档：

./feishu-doc-export --appId=xxx --appSecret=xxx --type=cloudDoc --folderToken=文件夹标识 --exportPath=导出路径

获取folderToken方法：

1. 在飞书打开目标文件夹
2. 点击分享按钮
3. 从分享链接复制folder_token参数

定时自动备份方案

Linux用户可使用crontab设置定时任务：

# 每天凌晨2点自动备份 0 2 * * * cd /home/tools/feishu-export && ./feishu-doc-export --appId=xxx --appSecret=xxx --exportPath=/backup/feishu

⚠️ 常见问题解决

权限配置问题：

• 确保开通全部云文档权限
• 注意权限页面可能有分页需要翻页查看

Mac用户执行失败：

• 必须通过终端执行命令
• 不要直接双击运行

路径相关问题：

• 使用纯英文路径避免兼容问题
• 不要包含中文或特殊字符

💡 最佳实践建议

1. 首次使用选择DOCX格式- 确保格式完整性最佳
2. 批量导出选择非工作时间- 避免影响网络速度
3. 定期更新工具版本- 获取最新功能支持
4. 重要文档双重备份- 使用不同格式保存

现在你已经掌握了飞书文档一键导出的全部技巧！这个开源工具就像你的"智能文档管家"，让繁琐的导出工作变得轻松高效。无论是团队协作文档迁移还是个人资料备份，都能完美胜任。

核心源码参考：src/feishu-doc-export/ 配置帮助文档：src/feishu-doc-export/readme.md

【免费下载链接】feishu-doc-export项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export