3步搞定语雀文档备份：yuque-exporter使用全攻略

想把语雀文档安全保存到本地？试试yuque-exporter这款免费工具！它能帮你批量导出语雀文档，完整保留目录结构，让知识资产随时掌控在自己手中。无需专业技术，简单配置就能完成所有文档的本地化备份。

环境准备要点

安装Node.js运行环境

这是运行工具的基础，先检查电脑是否已安装：

node -v
npm -v

如果显示版本号，说明环境就绪。未安装的话，去Node.js官网下载安装包按提示操作即可。

安装Git工具（可选）

虽然可以直接下载源码，但用Git能更方便获取更新：

git --version

工具部署步骤

第一步：获取项目源码

打开命令行执行：

git clone https://gitcode.com/gh_mirrors/yuqu/yuque-exporter

第二步：进入项目目录

cd yuque-exporter

第三步：安装依赖包

npm install

等待几分钟，依赖安装完成后就可以开始使用了。

获取API令牌方法

要导出文档，需要先获取语雀API令牌：

1. 登录语雀官网
2. 进入个人设置
3. 找到API令牌管理
4. 创建新令牌并保存好

这个令牌就像一把钥匙，确保只有你能访问自己的文档。

开始导出操作

一切准备就绪后，在项目目录下运行：

YUQUE_TOKEN=你的令牌 npm start

把"你的令牌"替换成实际获取的API令牌，工具就会自动开始导出文档。

导出的文档默认保存在项目的 src/lib/ 目录，保持原有的文件夹结构，方便后续查找使用。

高效导出技巧

断点续传功能

如果导出过程中断，不用担心重复劳动。重新运行导出命令，工具会自动识别已导出的文件，从断点继续。

解决中文乱码

若遇到中文显示问题，可先设置环境变量：

export LANG=en_US.UTF-8

自定义输出路径

打开 src/config.ts 文件，修改里面的输出路径设置，就能将文档保存到你想要的位置。

进阶使用指南

对于有开发基础的用户，可以探索更多可能性：

• 调整 src/config.ts 文件中的参数，优化导出效果
• 查看 src/lib/ 目录下的代码，了解工具工作原理
• 根据需求修改源码，添加个性化功能

通过yuque-exporter，你可以轻松实现语雀文档的本地备份，不再担心平台依赖问题。无论是个人笔记还是团队文档，都能安全保存在本地，让知识管理更加自主可控。现在就动手试试，给你的文档上一份"安全保险"吧！