VSCode的Configure Display Language命令仅识别严格格式的zh-cn,选zh_CN、zh-CN、Chinese等均无效且无提示;必须完整输入命令名、手动点击zh-cn、点击Restart而非Reload Window,并确保安装微软官方语言包。

Configure Display Language 命令只认 zh-cn,其他写法全无效
VSCode 的 Configure Display Language 命令表面提供下拉列表,但实际只识别严格格式的 zh-cn 字符串。选 zh_CN、zh-CN、Chinese (Simplified)、zh 都不会生效,且不报错、不提示——界面照旧英文,让人误以为“设置成功了”。这是最常被卡住的点。
正确做法是:按 Ctrl+Shift+P(macOS 为 Cmd+Shift+P),输入完整命令名 Configure Display Language(注意大小写和空格),回车后在弹出列表中**手动向下滚动并明确点击 zh-cn 这一项**,不是靠搜索关键词匹配,也不是点带中文标签的条目。
必须重启进程,Reload Window 不加载语言资源
选完 zh-cn 后,VSCode 会弹出 “Restart to apply changes” 提示框。这里不能点 “Cancel” 或忽略,也不能用 Developer: Reload Window 替代——后者只会刷新渲染层,不重新初始化语言包加载逻辑,中文菜单、右键项、命令面板仍为英文。
Windows 用户需确认任务管理器中所有 Code.exe 和 Code Helper 进程已退出;macOS 用户建议执行 killall -u $USER 'Code Helper' 再启动,避免残留进程读取旧 locale 配置。
locale.json 是最终兜底方案,内容只能是 {"locale":"zh-cn"}
当命令面板打不开、列表里没 zh-cn、或反复重启仍无变化时,直接编辑配置文件是最稳的方式。它优先级高于 UI 操作,且不依赖插件是否启用。
定位并编辑 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"}(无空格、无 BOM、UTF-8 编码)。如果文件不存在就新建;如果存在但值是 "en",删掉重写。改完保存,彻底退出 VSCode 再启动。
装错插件会导致 Configure Display Language 命令消失
搜“中文”“汉化”安装的第三方插件(如 Chinese Language Pack、VSCode Chinese)极大概率破坏命令面板注册表。现象包括:Configure Display Language 在命令面板里搜不到、点开设置里的“Display Language”下拉为空、甚至触发 Cannot read property 'translate' of undefined 报错。
唯一安全有效的插件是微软官方发布的:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须为 Microsoft,扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans。安装后右下角若没弹出 Restart Now,检查插件是否被禁用(图标灰了),或手动卸载重装。
zh-cn 的格式校验、进程级重启的强制性、以及插件来源的不可妥协性——这三个点任意一个出偏差,整个流程就静默失败。


















