零基础实战：Obsidian插件全中文显示的高效解决方案

obsidian-i18n 是一款专为 Obsidian 用户设计的插件本地化工具，能帮助用户一键将英文插件界面转换为中文，解决因语言障碍导致的使用困难问题。通过智能翻译引擎和灵活的翻译模式，即使是新手也能轻松打造全中文的 Obsidian 工作环境，提升笔记效率。

技术原理解析：obsidian-i18n 如何实现插件汉化？

obsidian-i18n 采用“提取-翻译-注入”的工作流程，就像给插件安装了一个“语言转换器”。它首先从插件的 main.js 和 manifest.json 文件中提取需要翻译的文本，然后通过词典文件（zh-cn.json）进行翻译映射，最后将译文注入插件界面。整个过程会自动创建原文件备份（duplicate.js），确保安全性。

核心工作步骤

1. 提取：从插件的功能实现文件（main.js）、插件介绍文件（manifest.json）和外观样式文件（style.css）中提取 UI 信息和设置选项文本。
2. 翻译：通过本地词典、云端同步或 AI 翻译三种方式，将提取的文本翻译成中文。
3. 注入：将翻译后的文本注入插件界面，并自动备份原插件文件，防止出现功能异常。

一站式部署指南：3 步完成 obsidian-i18n 安装与配置

安装插件（约 5 分钟）

1. 插件市场安装（推荐）
   • 打开 Obsidian 设置 → 第三方插件
   • 关闭“安全模式”，点击“浏览社区插件”
   • 搜索“obsidian-i18n”并点击安装，启用插件后重启 Obsidian。
2. 手动安装

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

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

配置翻译模式（约 10 分钟）

obsidian-i18n 提供三种翻译模式，用户可根据需求选择：

本地文件模式

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

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

云端文件模式

支持多设备同步和社区协作：

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

AI 翻译模式

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

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

⚠️ 注意：使用 AI 翻译模式时，确保网络连接正常，API 密钥配置正确。

内置编辑器使用指南：轻松编辑翻译内容

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

使用步骤

1. 左侧面板：显示插件原文，用于定位待翻译内容。
2. 右侧面板：待翻译内容，注意只能翻译有意义的语句，不要翻译函数名（如“log”之类）。
3. 编辑区：选择一个词条后，在此处进行编辑，编辑后需保存。
4. 版本信息：填写译文版本号（如 1.0.0）和作者信息。
5. 保存：点击“保存”按钮将译文保存到对应词典文件。

故障排除与优化：解决翻译常见问题

翻译未生效怎么办？

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

如何更新翻译内容？

当插件版本更新时：

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

预防措施

• 定期备份翻译文件，防止意外丢失。
• 在修改词典文件前，先备份原文件。
• 启用“共建云端”时，确保译文质量，避免错误翻译。

进阶技巧：提升翻译效率的实用方法

技巧一：批量翻译

利用内置编辑器的“批量处理”功能，同时翻译多个相似词条，节省时间。

技巧二：自定义词典

在 translation/dict/ 目录下创建自定义词典文件，添加个性化翻译，覆盖默认译文。

技巧三：翻译质量优化

通过“译文审核”功能，邀请其他用户对翻译内容进行审核，提升译文准确性。

社区贡献指南：参与插件汉化，助力中文用户

obsidian-i18n 是一个社区驱动的项目，欢迎用户贡献翻译成果：

1. 提交翻译：在云端模式下，启用“共建云端”选项，提交自己的翻译。
2. 标记汉化状态：标记插件是否已汉化，帮助其他用户快速识别。
3. 反馈问题：在项目仓库中提交 issue，反馈翻译过程中遇到的问题。

版本更新日志

v1.0.0

• 初始版本，支持本地文件模式和基础翻译功能。

v1.1.0

• 新增云端文件模式，支持多设备同步。
• 优化内置编辑器，提升翻译效率。

v1.2.0

• 增加 AI 翻译模式，支持百度翻译和 OpenAI。
• 修复翻译未生效的问题，提升稳定性。