离线安装后搜不到Configure Display Language命令,说明语言包未注册进VSCode扩展系统;必须通过Extensions: Install from VSIX命令安装,再配置locale.json为{"locale":"zh-cn"}并彻底重启进程。

离线安装后 Configure Display Language 命令搜不到
这说明语言包根本没注册进 VSCode 扩展系统,不是“没生效”,而是“压根没装上”。VSCode 自 1.70 起已禁用双击或拖拽 .vsix 文件的安装方式,这类操作只是把文件复制到 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows),但不写注册信息、不激活、不触发资源加载。
必须通过命令面板走正规流程:
- 按
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 回车 - 在弹出窗口中选中你下载的
vscode-language-pack-zh-hans-*.vsix文件(认准发布者MS-CEINTL,ID 为ms-ceintl.vscode-language-pack-zh-hans) - 点击
Install,等待提示“Extension installed successfully” - 安装完成后,再按
Ctrl+Shift+P→ 输入Configure Display Language,此时命令才可被识别
Configure Display Language 选了 zh-cn 却还是英文界面
常见原因是 locale 配置没落到正确位置,或被其他配置覆盖。VSCode 1.70+ 已完全弃用 settings.json 中的 "locale" 字段,它会被静默忽略。
真正起作用的是独立的 locale.json 文件,且只认用户级路径:
- Windows:
%APPDATA%\Code\User\locale.json - Linux:
~/.config/Code/User/locale.json - macOS:
~/Library/Application Support/Code/User/locale.json
该文件内容必须是严格合法的 JSON,且仅含一行:
{"locale":"zh-cn"}
注意:zh-cn 必须全小写、用连字符、无空格;zh_CN、zh-hans、Chinese 全部无效。文件不能带 BOM,不能有注释,也不能放在工作区目录(如 .vscode/locale.json)下。
重启后右下角仍显示 en,设置页/命令面板还是英文
这不是语言包问题,而是 VSCode 后台进程没彻底退出。尤其在 Windows 上,任务栏图标右键退出 ≠ 进程终止——常驻后台的 Code.exe 进程会缓存旧语言状态。
务必执行完整退出流程:
- Windows:打开任务管理器 → 结束所有
Code.exe进程(包括“后台进程”标签页里的) - macOS:活动监视器中搜索
Code,强制退出全部相关进程 - Linux:终端运行
pkill -f "code --no-sandbox"或pkill -f "code"
然后再从开始菜单 / 应用坞重新启动 VSCode。若仍无效,检查系统 locale 干预:Windows 若启用 “Beta: Use Unicode UTF-8 for worldwide language support”,可能跳过语言包;Linux/macOS 下运行 echo $LANG,若输出 en_US.UTF-8,需临时改 export LANG=zh_CN.UTF-8 再启 VSCode。
远程开发(WSL / SSH)里中文不生效
本地装的语言包对远程窗口完全无效。VSCode 的语言包是按环境独立加载的:你在 Windows 本地装了中文包,不代表 WSL 里的 VSCode Server 就有。
必须在远程环境中重复操作:
- 在 WSL 或 SSH 连接的窗口中,按
Ctrl+Shift+P - 运行
Extensions: Install from VSIX(需提前把.vsix文件同步过去) - 再运行
Configure Display Language→ 选zh-cn→Restart
注意:远程环境的 locale.json 路径与本地不同,比如 WSL 下是 /home/xxx/.config/Code/User/locale.json,别误改成本地路径。
最易被忽略的一点:语言包 ID 和 locale 值不是一回事。官方包 ID 是 ms-ceintl.vscode-language-pack-zh-hans,但它要求你设的 locale 必须是 zh-cn —— 这是 VSCode 主程序内部协商机制决定的,不是拼写习惯问题。











