Skip to content

nvim workflow i18n

ES edited this page Jul 20, 2026 · 1 revision

Neovim 工作流:i18n

这套配置里的 i18n 不是“只会跳 JSON 文件”,而是一整套浏览、预览、跳转、编辑工作流


1. 入口

快捷键 作用
<leader>ik 浏览 keys
<leader>ip 查看当前 key 的翻译
<leader>id 跳到翻译定义
<leader>is 编辑翻译
<leader>ia 添加新 key
<leader>it 开关预览
<leader>ir 重载翻译索引

2. 最常用路线

我只想看有哪些 key

<leader>ik

适合:

  • 刚进一个项目,不熟 key 命名
  • 想先浏览 namespace 和分组

我在代码里看到一个 t(...),想知道它显示什么

把光标放到对应 key 上,然后按 <leader>ip

适合:

  • 看当前 key 在不同语言下是什么
  • 确认文案有没有翻错

我想直接去翻译文件

<leader>id

适合:

  • 想顺着 key 找源文件
  • 想看这个 key 附近还有哪些相关文案

我想直接改翻译

<leader>is

适合:

  • 当前 key 文案不对
  • 多语言内容要同步调整

3. 什么时候用 ia

<leader>ia 用于新增 key

适合:

  • 新写一个按钮或标题
  • 新增一条错误提示
  • 新增一组业务文案

如果项目里已经有 i18n 约定,优先走这个入口,而不是手工去 locale 文件里拼


4. itir

<leader>it

切换预览显示

适合:

  • 想在代码旁边直接看翻译值
  • 或者想临时关掉预览,减少视觉噪音

<leader>ir

重载翻译索引

适合:

  • 你刚改了 locale 文件
  • 新增了 key,但列表没立刻刷新

5. 推荐习惯

  • ik 看全局,再 ip 看单点
  • 想理解某个 key 的真实归属时,用 id
  • 改文案优先 is,新增文案优先 ia
  • 如果预览信息太多,就 it 临时关闭

6. 适合谁

这篇尤其适合:

  • React i18n 项目
  • monorepo 里多个 locale 目录
  • 有统一 key 约定的前端项目

如果你平时经常在 t('...')useTranslation()useT() 之间切换,这套工作流会比手翻 locale 文件快很多


7. 相关文档

Clone this wiki locally