Configure Display Language是唯一有效入口,因VS Code 1.70+已弃用settings.json的"locale"字段,仅通过该命令生成/更新合法locale.json(内容{"locale":"zh-cn"})并重启才能生效。

Configure Display Language 命令才是唯一有效入口
VS Code 1.70+ 版本起,settings.json 中写 "locale": "zh-cn" 已被完全弃用,设置界面里也找不到“Display Language”这类选项——它根本不在设置面板中。所谓“在设置中更改语言”,本质是误传;真正生效的只有内置命令 Configure Display Language,它是唯一能生成并写入合法 locale.json 的途径。
装错插件会导致 Configure Display Language 根本不出现
按 Ctrl+Shift+P 输入 Configure Display Language 后列表为空、无响应、或选完 zh-cn 仍无效?90% 是语言包没装对。必须只装这一项:
- 扩展名严格为:
Chinese (Simplified) Language Pack for Visual Studio Code - 发布者必须是:
Microsoft(图标带蓝勾) - ID 必须是:
ms-ceintl.vscode-language-pack-zh-hans - 其他所有带“汉化”“中文支持”字样的第三方插件一律卸载——它们不更新、不兼容、甚至注入异常脚本导致
Cannot read property 'translate' of undefined
选 zh-cn 不是选“中文(简体)”或 zh_CN
执行 Configure Display Language 后弹出的列表里,只认严格小写 + 短横线的 zh-cn。以下全是无效值:
-
zh(太模糊,VS Code 忽略) -
zh_CN(下划线格式,旧版遗留,2026 年已失效) -
Chinese或中文(简体)(纯显示名,不是 locale 值) -
zh-hans(虽语义正确,但 VS Code 当前只接受zh-cn)
选错后 locale.json 可能被写成非法内容,后续再选也不生效,得手动删掉该文件重来。
重启必须点 Restart,Reload Window 不起作用
执行命令后弹出提示:“需要重启窗口以应用更改”。这时有两个按钮:
- Restart:彻底关闭所有进程,重新加载全部配置(包括语言资源),必须点这个
- Developer: Reload Window:仅刷新前端 UI,不重读
locale.json,语言不会变
右下角状态栏即使点了 en → zh-cn 下拉切换,也只是临时改当前窗口,新打开的窗口仍回退英文——全局生效靠的是用户级 locale.json 文件存在且内容为 {"locale":"zh-cn"},路径必须对(Windows 是 %APPDATA%\Code\User\locale.json,macOS 是 ~/Library/Application Support/Code/User/locale.json)。
最常被忽略的一点:Remote-SSH 或 WSL 里的 VS Code 实例,语言配置是独立的,得在远程机器上单独配一遍 ~/.vscode-server/data/Machine/*/locale.json。本地设好了,远程还是英文,不是失败,是漏了这步。


















