告别英文障碍：obsidian-i18n让Obsidian插件全界面中文显示

当你安装了10个Obsidian插件却因全英文界面望而却步时，当你对着"Settings"和"Preferences"选项犹豫不敢点击时，当你因不理解插件功能而错失效率提升机会时——obsidian-i18n这款开源工具正是为解决这些痛点而生。作为专为中文用户打造的插件本地化解决方案，它能让所有Obsidian插件界面实现完美的中文显示，彻底消除语言障碍，让你专注于内容创作而非界面解读。

为什么选择obsidian-i18n进行插件汉化

在众多翻译工具中，obsidian-i18n脱颖而出的三大核心优势：

安全无忧的翻译机制
自动为每个插件创建备份文件（duplicate.js），就像给手机相册开启自动备份功能，即使翻译过程出现问题，也能一键恢复原始状态，杜绝因翻译导致的插件功能异常。

灵活多元的翻译模式
提供本地文件、云端同步和AI翻译三种模式，满足不同场景需求：单机用户可选择本地模式，多设备用户适合云端同步，追求效率的用户则能通过AI翻译快速获取译文。

持续进化的翻译质量
基于社区协作的翻译词典库，就像维基百科一样不断优化，每个用户都能贡献自己的翻译成果，让译文质量随着使用人数增长而持续提升。

两种典型应用场景：

• 学术研究者：需要使用大量专业插件但英文阅读效率低
• 团队协作：团队成员英文水平参差不齐，统一中文界面降低协作门槛

快速了解obsidian-i18n的工作原理

obsidian-i18n采用"提取-翻译-注入"的三段式工作流程，确保在不破坏插件原有功能的前提下完成界面汉化。

从工作原理简图可以看到：

1. 提取阶段：从插件的main.js和manifest.json中精准提取UI文本信息
2. 翻译阶段：通过词典文件（zh-cn.json）进行文本映射，支持三种翻译方式
3. 注入阶段：将翻译后的文本注入插件界面，同时自动创建原文件备份

整个过程就像给插件穿上"中文外衣"，既保留原有功能，又让界面焕然一新。

插件汉化的准备工作

环境要求

• Obsidian 0.15.0及以上版本
• 已安装需要汉化的目标插件
• 网络连接（仅云端模式和AI翻译需要）

安装方法

插件市场安装（推荐）

1. 打开Obsidian设置 → 第三方插件
2. 关闭"安全模式"，点击"浏览社区插件"
3. 搜索"obsidian-i18n"并安装启用

手动安装方法

git clone https://gitcode.com/gh_mirrors/ob/obsidian-i18n

💡 复制代码后，将下载的文件夹移动到Obsidian的插件目录（Vault/.obsidian/plugins/），重启软件即可。

核心配置：三种翻译模式设置方法

本地文件模式配置

适合单机用户，所有翻译文件存储在本地：

1. 在插件设置中确保"本地文件模式"开关已开启
2. 启用"词典重载"功能，自动适配插件版本更新
3. 翻译文件保存在translation/dict/目录下，可手动编辑

⚠️ 注意：当插件版本更新时，建议先备份自定义翻译内容。

云端文件模式配置

适合多设备同步和社区协作：

配置步骤：

1. 在基础设置中切换"云端文件模式"为开启状态
2. 配置API接口地址（社区共享服务器）
3. 启用"共建云端"选项可贡献自己的翻译成果

💡 核心要点：云端模式下，你的翻译贡献会帮助所有使用该模式的用户。

AI翻译模式启用

适合需要快速翻译的场景：

1. 在设置中开启"机器翻译模式"
2. 配置百度翻译API或OpenAI密钥
3. 选择翻译优先级和质量参数

内置编辑器使用技巧

内置编辑器是翻译工作的核心工具，专为插件汉化优化：

使用技巧：

• 左侧面板显示插件原文，右侧为待翻译内容
• 编辑区支持逐句翻译，核心要点：只翻译有意义的语句，保留函数名和代码结构
• 翻译完成后填写版本号（如1.0.0）和作者信息
• 点击"保存"按钮将译文保存到对应词典文件

进阶功能：提升翻译体验的技巧

多设备同步设置

1. 确保所有设备都启用云端模式
2. 使用相同的API接口地址
3. 定期同步翻译文件，避免版本冲突

翻译质量优化

• 优先使用社区已验证的翻译结果
• 对专业术语建立个人翻译词典
• 定期更新词典文件获取最新翻译

常见误区解析

误区一：翻译后插件无法使用
这通常是因为误译了函数名或代码结构。正确做法是只翻译引号内的文本内容，保留代码结构不变。

误区二：云端模式翻译不更新
检查网络连接，确保"共建云端"选项已启用，必要时手动点击"同步词典"按钮。

误区三：AI翻译质量不佳
可在设置中调整翻译引擎参数，或对AI翻译结果进行人工修正后保存到本地词典。

参与社区贡献，共同完善翻译库

obsidian-i18n的强大之处在于社区协作。当你翻译了某个插件的界面文本后：

1. 在编辑器中填写你的作者信息
2. 启用"共建云端"选项
3. 点击"提交翻译"按钮

你的每一份翻译贡献，都将帮助更多中文用户跨越语言障碍，享受Obsidian的全部功能。现在就安装obsidian-i18n，让所有插件都为你"说"中文，同时成为开源社区的贡献者！