更新记录

0.1.0(2026-07-24) 下载此版本

能用的


平台兼容性

HbuilderX/cli最低兼容版本
4.01

HBuilderX插件通用注意事项

HBuilderX-2.7.12以下版本安装插件市场内的插件后,卸载时需手动卸载,详细教程参考:如何手动卸载插件


I18n Assistant

面向 HBuilderX、Vue 和 uni-app 项目的多语言辅助插件,帮助你在编辑代码时快速查看、补全和检查多语言文案。

功能

  • $t()t() 等语言键后显示目标语言译文。
  • 悬停查看全部语言翻译和缺失状态。
  • 使用“转到定义”跳转到语言文件中的对应位置。
  • 在翻译函数中自动补全语言键。
  • 标记未定义或缺少目标语言翻译的键。
  • 搜索语言键或译文,并跳转到定义。
  • 生成各语言相对于源语言的缺失翻译报告。
  • 从状态栏或命令菜单切换显示语言。

快速开始

  1. 安装插件并重启 HBuilderX。

  2. 打开包含语言文件的 Vue、JavaScript 或 TypeScript 项目。

  3. 在代码中使用语言键,例如:

    $t("home.title");
  4. 插件会自动扫描项目中的语言文件,并在语言键后显示译文。

默认显示语言为 zh-CN,缺失报告的源语言为 en

常用操作

操作 入口
搜索多语言键 Windows/Linux:Ctrl+Alt+I;macOS:Command+Option+I
切换显示语言 点击状态栏中的 i18n: 语言,或使用“I18n Assistant”菜单
查看全部翻译 鼠标悬停在语言键上
跳转到语言定义 在语言键上使用 HBuilderX 的“转到定义”
查看缺失报告 “工具 → I18n Assistant → 查看缺失翻译报告”
刷新索引 “工具 → I18n Assistant → 刷新语言索引”

支持范围

翻译调用

默认支持:

$t("home.title");
this.$t("home.title");
uni.$t("home.title");
t("home.title");
i18n.t("home.title");
i18n.global.t("home.title");

Vue 模板也支持:

<i18n-t keypath="home.title" />
<p v-t="'home.title'"></p>

支持 .json.jsonc.json5.js.cjs.mjs.ts.yaml.yml

插件会自动识别 localelocalesi18nlanglanguagesmessages 等目录,例如:

src/locales/en.json
src/locales/zh-CN.json

也可以在配置中添加自定义目录。

注意事项

  • JS/TS 语言文件只解析静态对象,不执行项目代码。
  • 动态语言键(如 $t(prefix + name))无法进行静态补全、跳转和检查。
  • 保存语言文件后插件会自动更新索引;如未更新,可手动执行“刷新语言索引”。
  • 插件只在本地读取项目语言文件,不上传项目内容或连接远程服务器。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

1. 本地项目文件读取权限:用于扫描当前打开项目中的代码文件及多语言资源文件,并在本地建立语言键索引。 2. HBuilderX 编辑器及工作区访问权限:用于显示内联译文、悬停提示、代码补全、缺失翻译诊断及跳转到语言定义。 3. 插件配置读写权限:用于读取和保存显示语言、语言文件路径、翻译函数名称等插件设置。 本插件不申请摄像头、麦克风、定位、通讯录、相册等操作系统级权限,不执行外部程序,不修改或删除用户项目文件。

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

本插件不采集、上传或对外发送任何用户数据,不连接任何远程服务器,也未集成第三方数据采集 SDK。 插件仅在用户本地读取当前打开项目中的代码文件和多语言资源文件,用于建立语言键索引,并提供内联译文、悬停查看、代码补全、跳转定义、语言键搜索及缺失翻译检查等功能。索引数据仅在本地内存中使用,不会上传或分享给第三方。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无。本插件不包含任何形式的广告,不展示广告内容,也不集成第三方广告 SDK。

许可协议

MIT License

Copyright (c) 2026

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

暂无用户评论。