终极Obsidian插件翻译指南：如何用i18n插件轻松实现国际化 🚀

Obsidian-i18n是一款专为Obsidian插件开发者和用户设计的一站式国际化翻译工具。它能自动识别插件源代码中需翻译的内容，生成待翻译词典，并提供本地文件、云端文件和机器翻译三种灵活模式，帮助你轻松实现Obsidian插件的多语言支持。

📌 为什么选择Obsidian-i18n？

作为Obsidian生态中最受欢迎的翻译工具，Obsidian-i18n凭借以下优势脱颖而出：

• 智能识别：自动扫描插件代码中的可翻译文本（支持正则匹配）
• 多模式翻译：本地编辑/云端同步/机器翻译三大模式自由切换
• 动态注入：无需重启Obsidian即可实时加载/卸载翻译词典
• 社区驱动：已支持官方插件市场Top100热门插件，持续更新中

Obsidian-i18n的核心工作流程：从文本提取到动态注入的完整链路

🔧 快速安装指南

方法一：手动安装（推荐新手）

1. 下载最新版本插件包（包含main.js、manifest.json、styles.css）
2. 打开Obsidian → 设置 → 社区插件 → 关闭"安全模式"
3. 点击"浏览" → "手动安装插件" → 选择下载的插件包

方法二：源码编译安装

git clone https://gitcode.com/gh_mirrors/ob/obsidian-i18n
cd obsidian-i18n
npm install
npm run build

编译完成后，将dist文件夹中的文件复制到Obsidian插件目录的i18n文件夹下。

🚀 三种翻译模式全攻略

🌐 云端文件模式（最快上手）

1. 在插件设置中启用「云端文件模式」
2. 点击侧边栏的「i18n按钮」
3. 找到目标插件，点击「下载」按钮获取社区翻译
4. 下载完成后点击「翻译」按钮即可自动注入词典

💡 小技巧：云端模式会优先使用社区贡献的优质翻译，适合快速部署多语言支持

📝 本地文件模式（自定义翻译）

1. 启用「本地文件模式」并设置词典保存路径
2. 选择插件后点击「提取」按钮生成待翻译词典
3. 点击「编辑」按钮打开内置编辑器
4. 完成翻译后点击「应用」即可生效

翻译文件将保存在：translation/dict/[插件ID]/zh-cn.json

🤖 机器翻译模式（高效辅助）

1. 在「机器翻译设置」中配置API接口（支持多种翻译服务）
2. 提取词典后点击「机器翻译」按钮自动生成译文
3. 检查译文无误后点击「注入」完成翻译

⚠️ 注意：机器翻译结果需人工校对，建议用于初稿翻译

💡 最佳实践与避坑指南

🔍 翻译质量保障

• 优先使用社区验证的词典：translation/contributor/zh-cn.json
• 翻译前备份原始文件：src/data/backup/
• 使用「还原」按钮快速回滚错误翻译

📊 性能优化建议

• 定期清理未使用的词典：设置 → 高级 → 清理缓存
• 大型插件建议分批次翻译：每次处理不超过500条文本
• 启用「懒加载」模式：仅在使用插件时加载对应词典

🎯 常见问题解决方案

Q：翻译后界面没有变化？

A：尝试按Ctrl+Shift+I打开开发者工具，检查控制台是否有错误提示，通常是词典格式错误导致。

Q：如何贡献翻译？

A：编辑本地词典后，通过「贡献翻译」按钮提交到社区库，审核通过后将出现在云端模式中。

Q：支持哪些语言？

A：目前已支持20+种语言，核心翻译文件位于src/lang/目录

🌟 生态支持与未来规划

Obsidian-i18n已成为插件国际化的标准解决方案，目前支持：

• 官方热门插件：Excalidraw、Dataview、Kanban等
• 社区精选插件：Style Settings、Templater、Omnisearch
• 主题翻译：支持自定义主题文本翻译theme/dict/

未来将推出「实时协作翻译」和「翻译记忆库」功能，进一步提升多语言支持效率。

🎉 现在就开始：用Obsidian-i18n让你的插件走向全球，触达更多用户！