i18n 中文查找器

i18n 中文查找器是一个 Visual Studio Code 扩展,旨在帮助开发者快速定位国际化(i18n)文本在代码中的使用位置。

开发者

本扩展由以下开发者共同开发:

• Endless
• Cursor

功能特性

1. 双模式搜索系统：
   • 工作区搜索模式：在整个工作区中搜索，显示详细的结果面板
   • 当前文件搜索模式：仅在当前打开的文件中搜索，使用原生界面快速导航
2. 智能搜索导航：
   • 支持使用 F3/Shift+F3 在搜索结果间快速跳转
   • 实时高亮显示所有匹配项和当前选中项
3. 多文件类型支持：支持 .js, .ts, .vue, .jsx, 和 .tsx 文件搜索
4. 交互式结果面板：
   • 代码语法高亮显示
   • 可展开/折叠的代码预览
   • 实时搜索进度显示
   • 懒加载渲染，优化大量结果的显示性能
5. 高性能优化：
   • 文件索引缓存和文档缓存
   • 批处理文件处理，动态调整处理速度
   • 防抖搜索，减少不必要的计算
6. 自定义配置：支持自定义快捷键和搜索排除模式

安装

1. 打开 VS Code
2. 转到扩展视图 (Ctrl+Shift+X 或 Cmd+Shift+X on macOS)
3. 搜索 "i18n 中文查找器"
4. 点击 "安装" 按钮

使用方法

工作区搜索模式 (推荐用于大范围查找)

1. 使用快捷键 Ctrl+Shift+F (Mac 上是 Cmd+Shift+F) 或在命令面板中输入 "查找中文文本 (Webview)" 来启动工作区搜索。
2. 在弹出的输入框中输入要查找的中文文本。
3. 扩展将搜索工作区中的所有相关文件，并在详细的结果面板中显示匹配项。
4. 在结果面板中，您可以:
   • 查看每个匹配项的文件路径、行号和上下文代码
   • 点击匹配项以在编辑器中打开相应文件并跳转到匹配行
   • 点击"显示代码"查看语法高亮的代码预览
   • 使用内置的搜索框执行新的搜索

当前文件搜索模式 (推荐用于快速定位)

1. 使用快捷键 Ctrl+Shift+I (Mac 上是 Cmd+Shift+I) 或在命令面板中输入 "I18n 当前文件查找" 来启动当前文件搜索。
2. 在原生搜索界面中输入要查找的中文文本。
3. 实时显示当前文件中的匹配结果，所有匹配项会被高亮标记。
4. 使用上下箭头键或鼠标选择结果，按回车键跳转到选中位置。

搜索结果导航

• F3：跳转到下一个搜索结果
• Shift+F3：跳转到上一个搜索结果
• 当前结果会以绿色边框特别标记，其他结果以粉色背景标记

配置选项

在 VS Code 设置中，您可以自定义以下选项:

1. i18nFinder.excludePatterns: 设置要从搜索中排除的 glob 模式数组。

   • 默认值: ["**/node_modules/**"]
   • 说明: 用于排除不需要搜索的文件和目录

2. i18nFinder.excludeDirs: 设置在查找 i18n 文件时要排除的目录名称。

   • 默认值: ["node_modules"]
   • 说明: 查找 zh-CN i18n 资源文件时跳过的目录

3. i18nFinder.keyBinding: 自定义快捷键绑定。

   • 默认值: "ctrl+shift+f"
   • 说明: 工作区搜索模式的快捷键设置

快捷键总览

自定义快捷键

您可以通过以下方式自定义快捷键:

方法一：通过设置界面

1. 打开 VS Code 设置 (文件 > 首选项 > 设置)
2. 搜索 "i18n Finder"
3. 在 "I18n Finder: Key Binding" 字段中修改工作区搜索的快捷键
4. 重启 VS Code 以使更改生效

方法二：通过键盘快捷键设置

1. 打开 VS Code 键盘快捷键设置 (文件 > 首选项 > 键盘快捷键)
2. 搜索 "i18n-finder" 查看所有相关命令:
   • i18n-finder.findByText: 工作区搜索模式
   • i18n-finder.nativeSearch: 当前文件搜索模式
   • i18n-finder.nextResult: 下一个搜索结果
   • i18n-finder.previousResult: 上一个搜索结果
3. 点击命令旁的编辑图标自定义快捷键

注意事项

1. i18n 文件结构：该扩展会在工作区中搜索 zh-CN 目录下的 JSON 文件作为 i18n 资源文件。请确保您的项目遵循这种目录结构。

2. 性能优化：

   • 扩展已内置多种性能优化策略，包括文件缓存、索引缓存和批处理
   • 对于大型项目，建议使用"当前文件搜索模式"进行快速定位
   • 工作区搜索会显示实时进度，请耐心等待

3. 搜索模式选择：

   • 当前文件搜索 (Ctrl+Shift+I)：适用于已知文件位置的快速查找
   • 工作区搜索 (Ctrl+Shift+F)：适用于不确定位置的全面搜索

4. 性能调优：如果遇到性能问题，请尝试调整 excludePatterns 和 excludeDirs 设置以排除不必要的文件和目录。

5. 搜索结果导航：使用 F3/Shift+F3 可以在搜索结果间快速跳转，无需鼠标操作。

问题反馈

如果您在使用过程中遇到任何问题或有改进建议,请在 GitHub 仓库中提交 issue。

贡献

欢迎贡献代码、报告 bug 或提出新功能建议。请查看 GitHub 仓库了解更多信息。

许可证

本扩展遵循 MIT 许可证。详情请参阅 LICENSE 文件。

感谢您使用 i18n 中文查找器!希望它能够提高您的开发效率。如果您觉得它有用,请考虑给我们的 GitHub 仓库点个星。祝您使用愉快!