VSCode设置中文界面不生效,90%因未执行Configure Display Language命令或未点重启;必须安装Microsoft官方插件ms-ceintl.vscode-language-pack-zh-hans,手动选zh-cn并彻底重启,locale.json内容须为{"locale":"zh-cn"}且路径准确。

VSCode设置中文界面不生效,90% 是因为没执行 Configure Display Language 命令,或执行后没点“重启”——装插件只是备好字典,不调这个命令,VSCode 根本不知道要用它。
装错了插件:只认 ms-ceintl.vscode-language-pack-zh-hans
搜“中文”“汉化”很容易装到第三方包,比如 Chinese Menu 或 VSCode Chinese。它们只改顶部菜单几个字,不翻译设置页、命令面板、错误提示,还可能引发乱码。
- 真正起效的只有一个:
Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 是ms-ceintl.vscode-language-pack-zh-hans - 安装时必须输入完整名称,不能只输
chinese;认准蓝白 VS 图标 + 蓝勾认证 - 安装完右下角会弹出 Change Language and Restart 提示——必须点它;点
Reload Window不生效
Configure Display Language 命令选错值或没写入
这个命令不是“选中文”,而是往 locale.json 写一个 BCP 47 标识符。任何变体都会静默失败,界面维持英文且无报错。
- 必须从下拉列表中手动滚动找到并点击
zh-cn(全小写、连字符、无空格);zh_CN、ZH-CN、zh-hans、Chinese全无效 - 弹窗提示“是否重启窗口”时,必须点是;点“否”或关掉弹窗,配置根本不会写入
locale.json - 文件路径必须精准:
%APPDATA%\Code\User\locale.json(Windows)、~/Library/Application Support/Code/User/locale.json(macOS)、~/.config/Code/User/locale.json(Linux) - 内容只能是严格合法 JSON:
{"locale":"zh-cn"}(UTF-8 无 BOM、无多余空格、无逗号、无注释)
配置被覆盖或缓存残留
即使 locale.json 正确,工作区设置、远程开发环境、IT 策略插件或旧缓存仍可能导致部分界面卡在英文状态。
- 检查
.vscode/settings.json是否写了"locale": "en"—— 工作区设置会覆盖用户级配置 - 远程开发(SSH / Dev Container)有独立的
locale.json,需在远程端单独运行Configure Display Language - 清除缓存目录:
%APPDATA%\Code\Cache和%APPDATA%\Code\Local Storage(Windows),再彻底退出所有Code.exe进程 - 企业环境可能通过组策略强制锁定语言,此时需联系 IT 管理员
最易被忽略的是:VSCode 1.80+ 版本支持在 settings.json 中直接写 "locale": "zh-cn",这个字段优先级高于 locale.json,且不会被版本更新覆盖。但要注意——它只对主窗口生效,终端和调试控制台仍需额外配置环境变量或启动参数。


















