VS Code 中 Configure Display Language 不显示 zh-cn 是因语言包未被识别,需确认插件启用且版本≥1.89.2026052801,手动配置 locale.json 路径及内容,并彻底重启;远程环境需单独安装语言包并重新配置。

Configure Display Language 命令不显示 zh-cn 选项
插件装了、也启用了,但命令面板里搜 Configure Display Language 后列表为空或只有 en,这不是插件失效,而是 VS Code 没识别到语言包已就绪。
先确认扩展页中 Chinese (Simplified) Language Pack for Visual Studio Code 状态为“启用”,且版本号 ≥ 1.89.2026052801(2026 年 5 月底起强制兼容 ozone 渲染路径);
再用命令面板运行 Preferences: Configure Language,它会直接打开 locale.json —— 若报错“文件不存在”,说明配置层被跳过,需在用户级 settings.json 中手动补一行:"locale": "zh-cn";
注意:改完必须彻底重启 VS Code,Reload Window 不会重载语言资源。
locale.json 放错路径或格式错误
VS Code 只读取特定路径下的 locale.json,且严格校验 JSON 格式和字段值。常见错误包括:
- 把
locale.json写成settings.json,或误存到工作区目录(.vscode/)而非用户目录 - Windows 路径应为
%APPDATA%\Code\User\locale.json,不是%APPDATA%\Code - Insiders\User\ - macOS 路径是
~/Library/Application Support/Code/User/locale.json,不是~/Library/Preferences/ - Linux 路径是
~/.config/Code/User/locale.json,内容只能是{"locale":"zh-cn"}(英文引号、小写、短横线,不能是zh_CN或Chinese)
若企业策略设了 VSCODE_LANG=en 环境变量,或右下角 locale 显示灰色不可编辑,说明配置被强制覆盖——此时改文件无效,得先清除环境变量或组策略限制。
中文能显示但输入法在编辑器内失灵
菜单和设置是中文,但写代码时打不出汉字,这和汉化插件完全无关,属于 Electron 层输入法事件拦截问题。
Linux / WSL2 用户必须设环境变量:export GTK_IM_MODULE=fcitx5(Fcitx5)或 export GTK_IM_MODULE=ibus(IBus),并确保写入 ~/.profile(GUI 启动走 profile,~/.bashrc 不生效);
Windows 用户重点检查两处:terminal.integrated.windowsEnableConpty 设为 false;系统设置 → 语言 → 拼音选项 → 关闭「使用以前版本的微软拼音」;
macOS 用户需在终端执行:defaults write com.microsoft.VSCode ApplePressAndHoldEnabled -bool false,然后重启电脑。
Remote-SSH / WSL / Containers 下汉化失效
只在本地装了中文语言包,远程环境(如 WSL、SSH 主机、Docker 容器)仍显示英文,因为语言包未同步部署到远程端。
在远程窗口中,按 Ctrl+Shift+X 打开扩展面板,搜索并安装同一款 Chinese (Simplified) Language Pack for Visual Studio Code;
或在本地终端执行:code --install-extension MS-CEINTL.vscode-language-pack-zh-hans(注意大小写,ID 中的 MS-CEINTL 必须全大写);
远程安装后,仍需在该窗口中运行 Configure Display Language 并选 zh-cn,再重启远程窗口 —— 本地设置不会自动透传。


















