VS Code 1.70+ 必须通过“Configure Display Language”命令或手动编辑 locale.json(内容严格为{"locale":"zh-cn"})设置中文界面,settings.json 中的 locale 参数已被彻底弃用且静默忽略。

不能直接改 settings.json 里的 locale 参数来设中文界面——VS Code 1.70+ 已彻底弃用该配置项,写进去也静默忽略。
Configure Display Language 命令才是唯一合法入口
这个命令本质就是生成或更新用户级 locale.json 文件,并确保值为 {"locale":"zh-cn"}。它不读 settings.json,也不接受任何其他 locale 格式。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)打开命令面板 - 输入完整命令名:
Configure Display Language(注意大小写和空格,输成Change Language或Configure Language都匹配不到) - 从下拉列表中**必须选
zh-cn这一项**——ZH-CN、zh_CN、zh-hans、Chinese全无效,且无报错提示 - 弹窗提示“需要重启窗口”时,**必须点
Restart**;点Reload Window不会重载语言环境进程
手动编辑 locale.json 是硬核兜底方案
当命令面板卡死、UI 无响应、或批量部署时,直接写文件最可靠。它的优先级高于所有 UI 操作,且不依赖插件状态。
- 先彻底退出 VS Code:Windows 查任务管理器杀光所有
Code.exe;macOS 在活动监视器结束Code Helper;Linux 用pkill code - 定位并编辑该路径下的
locale.json文件:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:$HOME/Library/Application Support/Code/User/locale.json
– Linux:$HOME/.config/Code/User/locale.json - 文件内容**只能是严格的一行标准 JSON**:
{"locale":"zh-cn"}
– 不能有 BOM
– 不能有多余空格或换行
– 不能漏双引号或冒号
– 不能写成{"locale": "zh-cn"}(引号后带空格就失效)
为什么改了 settings.json 没反应?
因为 VS Code 从 1.70 版本起已移除对 settings.json 中 locale 字段的支持。你可能看到旧教程里写 "locale": "zh-cn",那是过时做法,2026 年已完全失效。
- 即使你手动加了这行,VS Code 启动时会直接跳过,不报错也不提示
- 它只认用户级
locale.json,且只在该文件存在时读取 - 远程开发(如 Remote-SSH、WSL)场景下,本地改了没用,得去远程机器的
~/.vscode-server/data/Machine/xxx/locale.json单独写
真正容易被忽略的是:右下角状态栏显示 en 就说明没生效,不用猜,直接查 locale.json 文件是否存在、路径是否正确、内容是否为严格格式的 {"locale":"zh-cn"} —— 这三处对了,顶部菜单栏、命令面板占位符、设置导航栏才会全中文。











