vscode中文界面异常主因是locale.json配置错误或缺失,需确保其内容为{"locale":"zh-cn"}且utf-8无bom编码;settings.json中"locale":"zh-cn"在v1.80+可生效;终端、插件ui及字体问题需单独处理。

VSCode中文界面显示异常,90%的情况不是语言包坏了,而是它根本没被正确“认领”——locale.json没写对、settings.json里漏配了"locale"、或者多个中文包在后台打架。直接修配置比反复重装快得多。
Configure Display Language 里没有 zh-cn 选项
这说明 VS Code 根本没识别到可用的中文语言包,常见于 v1.89+ 版本:
- 检查扩展页是否真安装了
ms-ceintl.vscode-language-pack-zh-hans(发布者必须是ms-ceintl),其他名称相似的都停用 - 语言包版本必须 ≥
1.89.2026052801;旧版会被静默忽略,卸载后手动删掉~/.vscode/extensions/ms-ceintl.vscode-language-pack-zh-hans-*全部文件夹再重装 - 打开
settings.json(Ctrl+, → 右上角“打开设置 (JSON)”),强制加一行:"locale": "zh-CN"(注意大小写,必须是ZH-CN,不是zh-cn) - 删缓存:
%APPDATA%\Code\Cache(Windows)、~/.config/Code/Cache(Linux/macOS),再重启
界面部分中文、部分英文或方块乱码
这不是语言包失效,而是渲染链断在了不同环节:
- 菜单栏/设置页中文正常,但 GitLens、ESLint 提示仍是英文 → 这些是插件自己的 UI,不走 VS Code 的 locale,得看插件是否声明支持
zh-cn(查其 GitHub Issues 或扩展页的 “Localization” 栏) - 终端(Terminal)或调试控制台仍为英文 → 终端语言由系统环境变量或 Shell 配置决定,和编辑器无关;可在
settings.json中加:"terminal.integrated.env.windows": {"LANG": "zh_CN.UTF-8"},或为 PowerShell profile 加chcp 65001 - 某处 label 显示方块(□□□)→ 极大概率是字体缺失,不是语言问题;检查
editor.fontFamily是否含明确中文字体,如'Microsoft YaHei UI', 'SimSun', 'monospace',且把中文字体放最前
locale.json 被改坏导致反复失效
这个文件是 VS Code 启动时读取的唯一语言依据,但容易被插件或手动编辑污染:
- 路径:Windows 是
%APPDATA%\Code\User\locale.json,macOS 是~/Library/Application Support/Code/User/locale.json,Linux 是~/.config/Code/User/locale.json - 内容必须极简,只允许一行合法 JSON:
{"locale":"zh-cn"};带注释、多行、额外字段(如"fallback")都会导致解析失败,VS Code 回退到英文 - 发现异常就直接清空该文件,手敲上面那行,保存,重启
真正难定位的是“半截汉化”:比如设置页里某个开关 label 是方块,但旁边按钮又是中文——这时候别再翻语言包,先调 editor.fontFamily,再查系统是否缺等宽中文字体。语言包只管翻译,不兜底字体渲染。











