3步解锁Obsidian全插件中文显示：新手友好的obsidian-i18n汉化指南

Obsidian的插件生态极大扩展了笔记功能，但英文界面常常成为中文用户的使用障碍。obsidian-i18n作为专为Obsidian设计的翻译工具，通过智能翻译引擎帮助用户一键将所有插件界面转换为中文，支持本地/云端翻译模式，让你轻松打造全中文的笔记环境。

为什么选择obsidian-i18n？核心价值解析 🚀

面对全英文的插件界面，许多用户会遇到设置选项看不懂、功能按钮不敢点的困境。obsidian-i18n作为Obsidian的专用翻译插件，具有三大核心优势：

• 安全无忧：自动备份原插件文件，避免修改导致的功能异常
• 灵活适配：支持本地翻译、云端同步和AI翻译三种模式
• 社区驱动：共享翻译成果，持续优化译文质量

5分钟了解obsidian-i18n工作机制 🔍

obsidian-i18n采用"提取-翻译-注入"的工作流程，确保翻译过程不破坏插件原有功能。

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

零基础安装obsidian-i18n的实施方案 📦

插件市场安装流程（推荐）

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

手动安装步骤

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

将下载的文件夹复制到Obsidian的插件目录（通常位于Vault/.obsidian/plugins/），重启软件即可。

三种翻译模式配置进阶技巧 ⚙️

本地文件模式设置方法

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

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

云端文件模式配置指南

云端模式支持多设备同步和社区协作：

配置步骤：

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

AI翻译模式启用教程

obsidian-i18n支持百度翻译和OpenAI两种AI引擎：

1. 在设置中开启"机器翻译模式"
2. 根据需要配置百度翻译API或OpenAI密钥
3. 选择翻译优先级和质量参数
4. AI翻译结果会保存在src/settings/ui/i18n-nit-*.ts相关文件中

内置编辑器高效翻译策略 ✍️

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

使用技巧：

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

常见问题解决方法 🛠️

翻译未生效的排查步骤

1. 检查目标插件是否已在i18n插件列表中启用
2. 验证翻译文件路径是否正确（通常在translation/dict/插件名/zh-cn/）
3. 尝试关闭并重新启用obsidian-i18n插件

插件版本更新后翻译内容同步方法

当插件版本更新时：

1. 开启"词典重载"功能自动适配
2. 手动编辑对应词典文件
3. 通过云端模式获取社区最新翻译

通过obsidian-i18n，无论是新手还是资深用户，都能轻松打造全中文的Obsidian工作环境。选择适合自己的翻译模式，享受无语言障碍的笔记体验。现在就安装obsidian-i18n，让每一个插件都为你"说"中文！