obsidian-i18n：告别插件英文界面烦恼，中文用户的全插件汉化工具

obsidian-i18n是一款专为Obsidian用户设计的全插件汉化工具，通过智能翻译引擎实现所有插件界面的中文显示。其核心优势在于安全可靠的备份机制、灵活多样的翻译模式选择以及社区共享的翻译成果，完美解决中文用户面对英文插件界面的使用障碍，适用于从新手到资深用户的各类Obsidian使用者。

价值定位：为什么选择obsidian-i18n？

在Obsidian的插件生态中，大量优秀插件仅提供英文界面，这给中文用户带来了理解设置选项、使用高级功能的困难。obsidian-i18n作为针对性解决方案，通过三大核心特性解决这一痛点：

• 安全无忧的翻译过程：自动创建原插件文件备份（duplicate.js），确保任何翻译操作都可回溯，避免破坏插件原有功能
• 多模式翻译适配：提供本地文件、云端同步和AI翻译三种模式，满足单机使用、多设备同步和即时翻译等不同场景需求
• 社区共建的翻译资源：通过共享词典文件（zh-cn.json）汇聚社区翻译智慧，持续优化译文质量

💡 实用小贴士：对于重要插件，建议在首次翻译前手动备份插件文件夹，双重保障数据安全。

工作原理解析：插件如何"说"中文？

obsidian-i18n采用"提取-翻译-注入"的三步工作流程，就像为插件安装了"语言转换器"。

从原理简图可以看到，系统首先从目标插件的main.js（功能实现文件）和manifest.json（插件描述文件）中提取需要翻译的UI文本，然后通过词典文件（zh-cn.json）进行翻译映射，最后将译文注入插件界面。整个过程会自动创建原文件备份，确保安全性。

三种翻译模式对比表

翻译模式	核心优势	适用场景	数据存储位置	更新方式
本地文件模式	完全离线使用，数据隐私性高	单机用户，网络环境受限	translation/dict/	手动编辑或词典重载
云端文件模式	多设备同步，社区协作	多设备用户，翻译贡献者	远程服务器	自动同步云端更新
AI翻译模式	即时翻译，无需等待社区	新插件，无现成翻译	src/settings/ui/	API实时翻译

💡 实用小贴士：定期检查翻译文件版本，当插件更新时启用"词典重载"功能可自动适配新版本界面变化。

多样化方案：三种安装与配置路径

安装方案：两种获取方式

插件市场安装（推荐新手） 第一步→打开Obsidian设置 → 第三方插件 第二步→关闭"安全模式"，点击"浏览社区插件" 第三步→搜索"obsidian-i18n"并点击安装，启用后重启Obsidian

手动安装方法（适合进阶用户） 第一步→执行克隆命令：git clone https://gitcode.com/gh_mirrors/ob/obsidian-i18n 第二步→将下载的文件夹复制到Obsidian插件目录（通常位于Vault/.obsidian/plugins/） 第三步→重启Obsidian完成安装

💡 实用小贴士：手动安装时需确保文件夹名称为"obsidian-i18n"，否则插件可能无法正常加载。

配置方案：三种翻译模式设置

本地文件模式配置 第一步→在插件设置中启用"本地文件模式"开关 第二步→开启"词典重载"功能（自动适配插件版本更新） 第三步→翻译文件将保存在translation/dict/目录下，可直接用文本编辑器修改

云端文件模式配置

第一步→在基础设置中切换"云端文件模式"为开启状态 第二步→配置API接口地址（如社区共享服务器） 第三步→填写访问令牌（如有需要），启用"共建云端"可贡献翻译成果

AI翻译模式配置 第一步→在设置中开启"机器翻译模式" 第二步→根据需要配置百度翻译API或OpenAI密钥（API密钥：访问接口的数字凭证） 第三步→选择翻译优先级和质量参数，AI翻译结果保存在src/settings/ui/i18n-nit-*.ts文件中

💡 实用小贴士：AI翻译模式建议仅用于临时翻译，最终译文最好手动校对后保存到本地或云端词典。

深度应用：内置编辑器使用指南

内置编辑器是obsidian-i18n的核心功能，专为插件汉化优化，提供直观的翻译工作界面。

编辑器使用步骤： 第一步→在插件列表中选择需要翻译的插件，点击"编辑"按钮打开编辑器 第二步→左侧面板查看插件原文，右侧面板显示待翻译内容 第三步→在编辑区逐句翻译，注意保留函数名和代码结构（如"log"、"Notice"等不要翻译） 第四步→填写译文版本号（如1.0.0）和作者信息，点击"保存"按钮

高级编辑技巧：

• 使用"新增"按钮添加未被自动提取的文本
• 翻译完成后建议对比插件实际界面效果进行微调
• 复杂插件可分多次翻译，编辑器会自动保存进度

💡 实用小贴士：翻译时特别注意保留占位符（如%s、{name}）和特殊符号，否则可能导致插件功能异常。

问题解决：常见故障排除指南

如何解决翻译未生效问题？

症状：启用翻译后插件界面仍显示英文 可能原因：

1. 目标插件未在i18n插件列表中启用
2. 翻译文件路径或命名错误
3. 插件缓存未刷新

解决方案： 第一步→检查i18n设置中的插件列表，确保目标插件已勾选 第二步→验证翻译文件是否位于translation/dict/插件名/zh-cn/目录下 第三步→关闭并重新启用obsidian-i18n插件，或重启Obsidian

如何处理插件更新后翻译失效？

症状：插件更新后之前的翻译内容丢失 可能原因：

1. 插件更新改变了UI文本结构
2. 词典文件未启用自动重载
3. 翻译文件版本与插件版本不匹配

解决方案： 第一步→在i18n设置中确认"词典重载"功能已启用 第二步→手动编辑对应词典文件，或通过云端模式获取更新 第三步→如结构变化较大，可使用"重新提取"功能更新待翻译文本

💡 实用小贴士：定期备份translation/目录下的翻译文件，可有效避免插件更新导致的翻译丢失。

通过obsidian-i18n，中文用户终于可以彻底告别英文插件界面的困扰。无论是选择本地模式保障隐私，云端模式实现多设备同步，还是AI模式快速获取译文，这款工具都能满足你的个性化需求。现在就开始配置属于你的中文Obsidian环境，让每一个插件都为你"说"中文！