必须安装 Microsoft 官方简体中文语言包(ID:MS-CEINTL.vscode-language-pack-zh-hans),配置 locale.json 为 {"locale":"zh-cn"} 并重启,才能使 Configure Display Language 命令生效且界面完全汉化。

Configure Display Language 命令搜不到?先确认语言包装对了
命令面板里输 Configure Display Language 没反应,90% 是根本没装上官方语言包,或者装错了第三方“汉化插件”。VS Code 不会把非 Microsoft 的扩展识别为合法语言资源,也就不会注册这个命令。
必须安装 ID 为 MS-CEINTL.vscode-language-pack-zh-hans 的扩展,发布者是 Microsoft,名称是 Chinese (Simplified) Language Pack for Visual Studio Code。其他所有带“汉化”“中文支持”字样的都别点——它们不提供 Configure Display Language 所依赖的底层接口。
- 按
Ctrl+Shift+X打开扩展面板,搜完整英文名,别用“中文”“chinese”等模糊词 - 安装后右下角若弹出
Restart Now,必须点它;只点Reload Window不会加载命令 - 装完仍搜不到命令?检查扩展是否被禁用(图标灰了),手动启用再试
搜到了 Configure Display Language 却选不了 zh-cn
命令能调出来,但列表里没有 zh-cn,或者点了“简体中文”文字项却没生效——这是常见陷阱:Configure Display Language 列表中显示的是语言名(如 Chinese (Simplified)),但真正写入配置的是它的值,即 zh-cn。VS Code 只认这个字符串,大小写、连字符、下划线全错一个就静默失败。
- 输入命令后回车,弹出的是下拉菜单,不是对话框;用方向键或鼠标选中
zh-cn这一项(它通常排在靠前位置) - 别选中文文字项(比如“简体中文”),那个只是 label,value 才是关键
- 选错一次,
locale.json可能被写成"locale": "zh"或"locale": "en",后续再选也无效,得手动删掉整行再重试
命令执行成功但重启后仍是英文界面
点了 Change and Restart,窗口也彻底关了再开,顶部菜单栏还是英文——大概率是 locale 配置没落在正确位置,或者被更高优先级设置覆盖。
- 确认
locale.json文件路径:Windows 是%APPDATA%\Code\User\locale.json,macOS 是~/Library/Application Support/Code/User/locale.json,Linux 是~/.config/Code/User/locale.json - 文件内容必须严格为
{"locale":"zh-cn"},不能多空格、逗号、BOM,也不能混在settings.json里 - 如果从终端启动 VS Code(例如
code .),检查终端的$LANG是否设为en_US.UTF-8等英文 locale,它会强行覆盖locale.json - Remote-SSH / WSL 场景下,本地
locale.json生效,但远程端的~/.vscode-server/data/Machine/locale.json必须单独配,否则远程窗口仍是英文
命令面板本身不响应?直接改 locale.json 最稳
命令面板卡死、输不了字、或反复重启都没反应,说明 UI 层已异常,这时候绕过命令面板,直写配置文件是最可靠兜底方式。
- 彻底退出 VS Code:Windows 查任务管理器杀光所有
Code.exe,macOS 在活动监视器结束Code Helper - 新建或编辑对应路径下的
locale.json,内容仅一行:{"locale":"zh-cn"} - 保存后重新启动,VS Code 会自动读取并应用,不再依赖命令面板状态
- 注意:不要往
settings.json里加"locale": "zh-cn",1.70+ 版本已弃用该字段,写了也白写
真正容易被忽略的是:命令面板里的搜索框提示文字(比如「请输入命令或搜索设置」)、设置界面左侧导航栏(「用户」「工作区」「扩展」)和顶部菜单栏(「文件」「编辑」「视图」)这三处全变中文,才算真正生效;终端、Git 输出、调试控制台这些默认保持英文,不是失败,而是它们走的是各自进程的语言环境。











