VS Code 中文界面需手动执行 Configure Display Language 命令并选 zh-cn,或直接编辑 locale.json 文件写入 {"locale":"zh-cn"}(UTF-8 无 BOM),settings.json 中的 locale 配置已无效。

装完插件菜单还是英文,不是插件没起作用,而是 VS Code 没被明确告知“现在用中文”。Configure Display Language 命令必须执行,且 zh-cn 是唯一有效值,其他写法全无效。
为什么装了 Chinese (Simplified) Language Pack 还是英文菜单
插件只提供翻译资源,不自动激活。VS Code 默认读取 en-us locale,即使系统是中文 Windows 也一样。常见卡点:
- 点了插件右上角的「重新加载窗口」,但没执行
Configure Display Language命令 - 命令面板里输错成
Change Language或Configure Language—— 正确命令名是Configure Display Language - 选语言时点了
Chinese (Simplified)文字项,或输zh、zh_CN、zh-hans—— 只有zh-cn被识别 - 右下角显示
en就说明没生效,别信其他区域(比如终端、Git 输出)的英文提示
手动写入 locale.json 是最稳的兜底方式
当命令面板打不开、列表里没 zh-cn、或反复切换失败时,直接改配置文件绕过 UI 层。这不是高级操作,而是刚需。
- 先彻底关闭所有 VS Code 窗口,包括后台进程(Windows 查任务管理器里有没有残留的
Code.exe) - 打开对应路径下的
locale.json:
– Windows:%APPDATA%\Code\User\locale.json
– macOS:$HOME/Library/Application Support/Code/User/locale.json
– Linux:$HOME/.config/Code/User/locale.json - 文件内容必须严格为:
{"locale":"zh-cn"}(无空格、无多余逗号、双引号和冒号用英文符号) - 编码必须是 UTF-8 无 BOM;用记事本保存时要选“UTF-8”,不能选“UTF-8 with BOM”
settings.json 里加 "locale": "zh-cn" 无效
VS Code 1.70+ 版本已弃用在 settings.json 中配置 locale 的方式。这个字段现在完全被忽略,写了也没用。
- 如果你在
settings.json里看到"locale": "zh-cn",删掉它 —— 它不仅无效,还可能干扰locale.json的读取 -
locale.json和settings.json是两个独立文件,前者专管界面语言,后者管编辑器行为 - 不要试图把两者混用;验证是否生效只看
locale.json是否存在且内容正确
验证是否真生效,只盯三处
别被局部英文骗了。终端、调试控制台、Git 输出、部分插件弹窗天生不走 locale 配置,显示英文属正常。
- 顶部菜单栏:检查「文件」「编辑」「视图」「终端」等是否为中文
- 命令面板:
Ctrl+Shift+P打开后,输入框上方提示是否为「请输入命令或搜索设置」 - 设置页面:
Ctrl+,进入后,左侧导航栏「用户」「工作区」「扩展」是否为中文
这三处全中文,才算真正汉化完成。其余地方英文不用管,也不用折腾。


















