i18n-ally 找不到 locales 是因路径未配置、子语言标签未声明、动态 key 不支持、VSCode 界面语言与插件无关,以及新语言文件需手动初始化。

为什么 i18n-ally 插件找不到你的 locales 文件夹
插件默认只扫描常见路径(如 src/locales、public/locales),如果你的翻译文件放在 src/i18n 或 assets/lang 这类自定义路径,它直接忽略——不是坏了,是没配对。
实操建议:
- 在 VSCode 设置里搜
i18n-ally.localesPaths,改成数组形式,比如["src/i18n", "src/assets/lang"] - 确保路径是**相对于工作区根目录**的,别写成绝对路径或带
./前缀 - 如果用的是 JSON 嵌套结构(如
{"common": {"submit": "提交"}}),记得开启i18n-ally.flattenNamespace,否则键名会显示成common.submit而不是submit - 重启 VSCode 或右键命令面板运行
i18n Ally: Reload Locales,缓存不自动刷新
i18n-ally 不识别 en-US 和 zh-Hans 这类子语言标签
插件默认只认基础语言码(en、zh),遇到带连字符的区域变体(en-US、zh-Hans)会当成无效 locale,导致右侧语言栏空、翻译键不高亮。
实操建议:
- 打开设置,修改
i18n-ally.languages,显式列出完整标签:["en", "en-US", "zh", "zh-Hans", "ja"] - 同时检查
i18n-ally.sourceLanguage是否设为其中某一个(比如"en"),否则源语言键可能无法被正确标记为“已翻译” - 注意:不同框架对子标签支持程度不同(Vue I18n v9 支持
zh-Hans,v8 只认zh),插件不会帮你校验运行时兼容性
翻译键在代码里写对了,但 i18n-ally 预览里显示 “missing”
常见于使用动态拼接 key 的场景,比如 t(`button.${type}`) 或 t(keys[i])。插件静态分析无法推断变量值,直接标红提示缺失——这不是 bug,是能力边界。
实操建议:
- 避免在
t()里用变量拼接,改用对象访问:t(buttons[type]),前提是buttons是字面量对象 - 对必须动态的场景,手动在对应 locale 文件中补全所有可能的 key,哪怕值先写占位符(如
"loading": "loading") - 启用
i18n-ally.warnIfMissing并设为false,避免干扰;但别关i18n-ally.showMissingKey,它能帮你发现真漏翻的 key - 如果用的是
useI18n()组合式 API,确认useI18n({ useScope: 'global' })没漏掉,否则插件可能找不到上下文
切换语言后 VSCode 界面没变,但项目里翻译生效了
i18n-ally 只管项目内多语言文件,不影响 VSCode 自身 UI 语言。你看到的“中文菜单”“英文提示”是编辑器系统设置,和插件无关。
实操建议:
- VSCode 界面语言由
locale.json控制(路径:$HOME/Library/Application Support/Code/User/locale.jsonmacOS /%APPDATA%\Code\User\locale.jsonWindows),改它才生效 - 插件右下角的语言切换按钮,只控制它自己预览区和内联提示所用的“参考语言”,不触发项目运行时切换
- 想实时看项目切换效果?得靠前端框架本身的 locale 切换逻辑(比如调用
i18n.locale = 'zh'),插件不提供运行时能力
最常被忽略的一点:插件不会自动创建新语言文件。新增 fr.json 后,必须手动在该文件里写至少一个键(哪怕只是 {"_": "_"}),插件才会把它纳入语言列表并允许翻译补全。











