VS Code中文界面生效需严格满足条件:locale.json路径正确、内容为{"locale":"zh-CN"}(CN大写)、UTF-8无BOM编码、文件位于用户级目录;远程开发需在对应哈希子目录单独配置。

locale.json 文件存在但界面仍是英文
文件存在不等于生效。VS Code 只接受严格格式的 locale.json,任何偏差都会导致静默失败并回退英文。
检查以下几点:
- 内容必须是单行、无空格、无注释:
{"locale":"zh-CN"}(注意:CN 必须大写,zh-cn或zh_CN均无效) - 双引号必须是英文半角,不能用中文引号或单引号
- 文件编码必须是 UTF-8 无 BOM;用 VS Code 自身打开该文件,右下角确认显示 “UTF-8”,若显示 “UTF-8 with BOM” 则点击切换
- 路径必须准确:Windows 是
%APPDATA%\Code\User\locale.json,macOS 是$HOME/Library/Application Support/Code/User/locale.json,Linux 是$HOME/.config/Code/User/locale.json - 文件不能放在项目级
.vscode/下,VS Code 完全忽略工作区里的locale.json
Configure Display Language 命令点不了 zh-CN
命令面板里搜不到 zh-CN,不是命令输错,而是官方语言包没装对或版本不匹配。
执行前先确认:
- 在扩展市场搜索
Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 必须是ms-ceintl.vscode-language-pack-zh-hans - 当前 VS Code 版本 ≥1.89 时,语言包版本必须 ≥
1.89.2026052801;旧版会被静默跳过 - 如果已安装但列表仍无
zh-CN,卸载后手动删除对应扩展文件夹:$HOME/.vscode/extensions/ms-ceintl.vscode-language-pack-zh-hans-*(Linux/macOS)或%USERPROFILE%\.vscode\extensions\ms-ceintl.vscode-language-pack-zh-hans-*(Windows) - 重装后重启 VS Code,再试命令 —— 输入
Configure Display Language后,务必手动滚动到末尾找zh-CN,搜索zh或Chinese不会命中
settings.json 里写了 "locale": "zh-CN" 却没用
VS Code 1.80+ 支持在 settings.json 中声明 "locale",但它有优先级前提:该字段必须是合法 JSON 且无语法错误,否则整个 settings.json 被跳过。
常见失效原因:
-
"locale": "zh-CN"前后有注释(如// 中文)—— JSON 不支持注释,整文件作废 - 末尾多逗号:
"locale": "zh-CN",—— 语法错误,VS Code 直接忽略该配置 - 用了中文冒号、空格或全角字符 —— 解析失败
- 同时存在
locale.json和settings.json中的"locale",但前者值为"en",而后者因语法错误未加载,实际生效的仍是locale.json
验证方式:打开命令面板 → Preferences: Open Settings (JSON),清空内容只留 {} 并保存,重启后若界面变纯英文默认态,说明原 settings.json 确实被跳过了。
远程开发(SSH/WSL)中插件页仍是英文
本地 locale.json 对远程实例完全无效。Remote-SSH 或 WSL 启动的是独立的 VS Code Server,它读取的是远程机器上的配置路径。
操作步骤:
- 连接到远程后,在集成终端运行:
code --list-extensions确认服务已就绪 - 进入远程路径:
~/.vscode-server/data/Machine/(后面是哈希子目录,如abc123...) - 在该哈希目录下新建或编辑
locale.json,内容严格为:{"locale":"zh-CN"} - 保存后,在远程窗口中执行
Developer: Reload Window(不是本地窗口!) - 远程端也需安装同版本官方中文语言包,否则只有配置没资源,照样显示英文
真正容易被忽略的是:远程路径中的哈希目录每次重装 server 都可能变化,不能靠记忆路径,必须进 ~/.vscode-server/data/Machine/ 下逐个查看最新子目录。


















