必须执行configure display language命令设locale为"zh-cn"并彻底重启,仅安装中文插件无效;locale.json须位于用户级目录且内容严格为{"locale":"zh-cn"}。

插件安装后界面仍是英文?先查 VSCode 语言设置
VSCode 默认语言由 locale 配置决定,和插件是否支持中文无关。很多用户装了中文插件(比如 Chinese (Simplified) Language Pack for Visual Studio Code)却没生效,是因为 VSCode 本身没切到中文 locale。
检查方法:按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Configure Display Language,回车——它会打开 locale.json 文件。确认内容是:
{ "locale": "zh-cn" }而不是 "en-us" 或空值。- 如果文件不存在,手动创建
locale.json,路径为:$HOME/.vscode/locales/(Linux/macOS)或%USERPROFILE%\.vscode\locales\(Windows) - 改完必须重启 VSCode,热重载不生效
- 某些远程开发场景(如 SSH、WSL)需在对应远程环境里也配置
locale.json
插件自身带 UI 的部分不显示中文?看插件文档里的 locale 支持声明
不是所有插件都自动适配系统语言。比如 ESLint、Prettier 这类工具型插件,默认只输出英文日志;而 GitLens、Remote - SSH 则明确支持 zh-cn 并随 VSCode locale 切换。
判断方式:打开插件详情页,在「Details」栏找「Localization」或「Supported Languages」字段。若只写「English」,那它的弹窗、提示、设置项就固定英文,装中文包也没用。
- 典型例外:
Code Spell Checker的拼写建议词典可单独切换语言,但 UI 仍为英文 - 有些插件(如
Polacode)UI 翻译靠社区贡献,新版才加zh-cn,旧版即使 locale 正确也显示英文 - 插件更新后语言可能回退,因为新版本重置了本地化资源缓存
中文字符显示为方块或乱码?重点查字体和终端编码
这是显示问题,不是翻译问题。常见于 Linux 或 macOS 终端内、编辑器侧边栏、或调试控制台中。
根本原因是缺少支持中文的等宽字体,或终端未启用 UTF-8 编码。VSCode 设置里搜 editor.fontFamily,确保值包含已安装的中文字体,例如:
'Fira Code', 'Microsoft YaHei', 'Noto Sans CJK SC', 'monospace'
- Windows 用户优先用
Microsoft YaHei;macOS 推荐PingFang SC;Linux 建议装Noto Sans CJK并确认 fontconfig 已刷新 - 集成终端乱码?检查
terminal.integrated.env.linux(或对应平台)里是否有LANG=zh_CN.UTF-8 - 某些字体(如
JetBrains Mono)默认不含中文,需搭配 fallback 字体使用,单写一个名字无效
插件弹窗/提示仍为英文?试试强制重载插件语言缓存
VSCode 1.80+ 版本对插件语言资源做了缓存优化,有时改完 locale.json 后,已安装插件的 UI 不刷新。这不是 bug,而是资源加载策略导致的延迟。
临时解决办法:按 Ctrl+Shift+P 输入 Developer: Reload Window With Extensions,而非普通重启。这个命令会清空插件语言缓存并重新加载所有本地化资源。
- 若仍无效,可删掉插件目录下的
node_modules和dist(或out)文件夹,再重装插件 - 个别插件(如
Todo Tree)需要手动在设置里开启todo-tree.general.language才启用中文 - 插件作者若把翻译文件放在
package.nls.zh-cn.json以外的路径(比如错写成nls.zh_CN.json),VSCode 就加载不到——这种属于插件发布缺陷,只能反馈给作者
真正卡住的地方往往不在“装没装”,而在 locale 配置是否落到正确位置、字体是否真能渲染、以及插件自己有没有把翻译文件打包进发布版。三者缺一不可。











