vscode离线安装中文语言包后configure display language命令不可见,需确认扩展已启用、版本≥1.70、彻底杀进程重启,并严格按路径和格式配置locale.json,远程环境须单独安装。

离线安装后 Configure Display Language 命令搜不到
说明 ms-ceintl.vscode-language-pack-zh-hans 没真正注册进扩展系统,只是把 .vsix 文件复制到了 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows),但没激活。
- 先执行
Extensions: Show Installed Extensions,确认列表里有ms-ceintl.vscode-language-pack-zh-hans且状态为 Enabled - 如果没有,卸载所有疑似中文插件,再用命令面板执行
Extensions: Install from VSIX重新选中官方.vsix文件安装 - 如果已有但禁用,手动点击启用,再试
Configure Display Language - 仍不出现该命令?检查 VSCode 版本是否 ≥1.70——旧版才支持双击安装;新版必须走命令面板,否则静默失败
点了 Restart Now 界面还是英文
VSCode 的 “Restart Now” 不等于彻底退出进程,尤其 Windows 和 macOS 容易残留后台进程,导致新窗口复用旧 locale 缓存。
- Windows:打开任务管理器 → 结束所有
Code.exe进程(包括 GPU、Utility、Renderer 类) - macOS:活动监视器 → 搜索
Code或Electron→ 全部强制退出 - Linux:终端运行
pkill -f "code.*--ms-enable-electron-run"或killall code - 重启前别信右下角弹窗提示——直接关掉所有窗口,再从桌面图标或命令行
code启动
locale.json 手动写对了但没生效
VSCode 只认 {"locale":"zh-cn"} 这一种格式,任何变体(zh_CN、zh-hans、ZH-CN)都会 fallback 到英文,且文件路径和编码必须精准。
- 路径必须是:
%APPDATA%\Code\locale.json(Windows)、~/Library/Application Support/Code/locale.json(macOS)、~/.config/Code/locale.json(Linux) - 内容只能是严格一行合法 JSON:
{"locale":"zh-cn"},不能有注释、多余空格、逗号或 BOM 头 - 不要往
settings.json里加"locale": "zh-cn"—— 这个字段在那里完全被忽略 - 保存后务必杀净进程再启动,否则读的仍是旧缓存
远程开发(SSH/WSL)界面仍是英文
本地装的中文包对远程窗口零影响。VSCode 的语言包是按环境独立加载的,远程机器上必须单独部署。
- 点击右下角状态栏的
SSH: xxx→ 选择Install 'Chinese (Simplified) Language Pack' in SSH: xxx - 安装完成后,在远程窗口中同样执行
Configure Display Language→ 选zh-cn→ 点 Restart - 若远程无图形界面,手动在远程机器上写入
locale.json:Linux 路径为~/.vscode-server/data/Machine/locale.json,Windows 远程为%USERPROFILE%\AppData\Roaming\Code\User\locale.json - 验证时只看顶部菜单栏、命令面板提示、设置导航栏三处——终端、Git 提示、右下角状态栏不参与 locale 切换
locale.json 写错格式、或者远程环境漏配。











