返回
创建于
状态
公开

i18n-ally 是一款专为 VS Code 设计的强大开源扩展，被誉为目前最先进的 国际化（i18n）辅助工具。它旨在解决多语言开发中“查找难、修改繁、管理乱”的痛点。

以下是它的核心功能与优势：

核心功能

  • 内联批注 (Inline Annotations)： 直接在代码中将翻译键（如 t('hello')）替换为对应的文字。你无需切换文件，就能一眼看出代码中显示的到底是什么内容。
  • 悬停预览 (Hover Preview)： 鼠标悬停在翻译键上时，可以即时查看和编辑所有语言版本的翻译。
  • 提取翻译 (Extract Translations)： 选中一段硬编码的字符串，右键即可将其提取到语言文件中，并自动生成对应的翻译键。
  • 编辑器 UI (Editor UI)： 提供一个可视化的管理面板，支持树状视图、搜索、过滤，甚至可以像编辑 Excel 一样批量管理翻译。
  • 机器翻译 (Machine Translation)： 支持调用 Google Translate、DeepL 或 LibreTranslate 等 API，一键将缺失的翻译补充完整。
  • 报告与分析： 自动检测项目中哪些键被漏掉了、哪些翻译是空的，或者哪些键在代码中已经不再使用了（Dead keys）。

为什么选择它？

  1. 框架支持极其广泛： 无论是 Vue (vue-i18n), React (react-i18next), Angular, Flutter, 还是 Go, PHP, Python 项目，它几乎都能通过配置支持。
  2. 极佳的开发体验： 它消除了在代码文件和庞大的 JSON/YAML 语言文件之间来回跳转的麻烦。
  3. 支持多种格式： 支持 JSON, YAML, JS, TS, PHP, Properties 等多种语言文件格式。

快速开始

  1. 安装： 在 VS Code 扩展市场搜索并安装 i18n-ally。
  2. 配置： 插件通常能自动识别项目中的 locales 文件夹。如果无法识别，你需要在项目根目录创建 .vscode/settings.json：
    json
    1{
2  "i18n-ally.localesPaths": "src/locales",
3  "i18n-ally.keystyle": "nested",
4  "i18n-ally.displayLanguage": "zh-CN"
5}
  3. 使用： 打开代码文件，你就会发现翻译键旁边出现了灰色的文字提示，侧边栏也会出现一个“A”字图标的 i18n 菜单。

小贴士： 如果你在团队开发中经常遇到翻译漏提、键名写错或者维护困难的问题，i18n-ally 几乎是必装的“神器”。