i18n 中文搜索插件
这是一个 VSCode 插件，用于在国际化项目中使用中文搜索 i18n 文本。
功能特性
- 🔍 中文搜索: 直接输入中文文本，自动查找对应的 i18n key
- 📊 智能匹配: 支持精确匹配和模糊匹配两种搜索模式
- 🎯 代码定位: 自动在代码中搜索 i18n key 的使用位置
- ⚙️ 配置灵活: 支持自定义语言文件目录和 i18n 函数名
使用方法
1. 快捷键搜索
- 按
Ctrl+Shift+S (Mac: Cmd+Shift+S) 在当前文件中搜索
- 按
Ctrl+K Ctrl+S (Mac: Cmd+K Cmd+S) 在所有文件中搜索
- 选择搜索模式（精确匹配或模糊匹配）
- 输入要搜索的中文文本，例如："行业模板"
- 插件会自动找到对应的 i18n key 并在代码中搜索使用位置
2. 右键菜单搜索
- 选中编辑器中的中文文本
- 右键选择 "用中文搜索 i18n 文本"
3. 命令面板搜索
- 按
Ctrl+Shift+P (Mac: Cmd+Shift+P) 打开命令面板
- 输入 "用中文搜索 i18n 文本"
配置
在 VSCode 设置中可以配置以下选项：
{
// i18n 语言文件目录路径
"i18nChineseSearch.localeDir": "src/locale",
// 中文语言包目录名
"i18nChineseSearch.chineseLocale": "zh-CN",
// i18n 函数名
"i18nChineseSearch.i18nFunctionName": "i18n.t"
}
支持的项目结构
插件支持以下项目结构：
项目根目录/
├── src/
│ └── locale/
│ ├── zh-CN/ # 中文语言包
│ │ ├── basic.json
│ │ ├── monitorConfig.json
│ │ └── ...
│ ├── en/ # 英文语言包
│ └── ...
语言文件格式
支持嵌套的 JSON 格式：
{
"monitorConfig": {
"industryTemplate": "行业模板",
"conventionalChart": "常规图表",
"general": "通用"
}
}
安装方法
开发版本
- 克隆或下载插件代码
- 在插件目录运行:
npm install
- 编译:
npm run compile
- 按 F5 启动扩展开发主机
- 在新窗口中测试插件
打包安装
- 安装 vsce:
npm install -g vsce
- 打包:
vsce package
- 安装生成的 .vsix 文件
命令列表
i18nChineseSearch.searchChinese: 用中文搜索 i18n 文本i18nChineseSearch.refreshIndex: 刷新 i18n 索引
注意事项
- 插件启动时会自动构建中文文本索引
- 当语言文件发生变化时，可以使用 "刷新 i18n 索引" 命令更新索引
- 插件会在 VSCode 的搜索面板中显示结果
贡献
欢迎提交 Issue 和 Pull Request 来改进插件功能。
许可证
MIT License
| |
