Obsidian插件全中文显示指南：从语言障碍到无缝体验

一、为什么插件汉化如此重要？

当你安装了Obsidian插件却面对满屏英文时，是否感到无从下手？插件汉化（将英文界面转换为中文显示）是中文用户的核心需求。obsidian-i18n作为专为Obsidian设计的翻译工具，能帮你解决这一痛点，让每个插件都"说"中文。

新手常遇的三大困境

• 设置选项看不懂：关键功能藏在英文菜单中
• 更新后翻译失效：插件升级导致旧翻译文件不兼容
• 多设备同步难：不同电脑上的翻译设置无法共享

二、解密插件汉化黑箱：obsidian-i18n工作原理

obsidian-i18n采用安全可靠的"提取-翻译-注入"工作流程，整个过程不会破坏原插件功能。

核心工作步骤解析

1. 智能提取：从插件的main.js和manifest.json中识别需要翻译的文本
2. 安全备份：自动创建原文件副本（duplicate.js），防止意外
3. 翻译映射：通过词典文件（zh-cn.json）建立中英文对应关系
4. 无缝注入：将翻译结果应用到插件界面，保持功能完整

三、选择你的翻译方案：三种模式深度对比

根据使用场景选择合适的翻译模式，是提升体验的关键一步。

翻译模式	适用场景	优势	配置难度
本地文件模式	单机用户	无需网络，完全离线	⭐⭐
云端文件模式	多设备用户	自动同步，社区共享	⭐⭐⭐
AI翻译模式	新插件/无词典	即时翻译，智能适配	⭐⭐⭐⭐

云端文件模式配置指南

云端模式特别适合需要多设备同步的用户，配置步骤如下：

1. 在插件设置中找到"云端文件模式"开关并开启
2. 配置API接口地址（社区共享服务器无需额外设置）
3. 启用"共建云端"选项可贡献你的翻译成果
4. 点击"同步"按钮获取最新社区翻译

四、实操指南：使用内置编辑器完成翻译

内置编辑器是obsidian-i18n的核心工具，专为插件汉化优化设计。

编辑器使用四步法

1. 选择插件：从左侧列表中选择需要翻译的插件
2. 定位文本：在左侧面板浏览待翻译的英文原文
3. 精准翻译：在右侧编辑区输入中文译文，注意保留函数名
4. 版本管理：填写译文版本号和作者信息后保存

💡 技巧：翻译时重点关注按钮文本、设置项名称等用户高频接触的内容，技术术语可保留英文或添加中文注释。

五、新手避坑指南

⚠️ 常见错误1：直接修改原插件文件
正确做法：始终通过obsidian-i18n进行翻译，它会自动处理文件备份

⚠️ 常见错误2：翻译函数名或代码
正确做法：只翻译自然语言文本，如"Loading..."，不要修改log()等代码元素

⚠️ 常见错误3：忽略版本兼容性
正确做法：插件更新后启用"词典重载"功能，自动适配新版本

六、进阶探索

1. 参与社区翻译共建

通过云端模式提交你的优质翻译，帮助更多中文用户。翻译文件位于translation/dict/目录下。

2. 自定义AI翻译引擎

在src/settings/ui/目录下的i18n-nit-baidu.ts和i18n-nit-openAI.ts文件中，可配置个性化翻译参数。

3. 批量管理翻译文件

使用script/update_vika.py脚本可批量检查和更新翻译词典，适合高级用户维护多插件翻译。

通过obsidian-i18n，你不仅能获得全中文的Obsidian体验，还能参与到开源社区的本地化工作中。从今天开始，让每一个插件都为你"说"中文！