必须用 extensions: install from vsix 命令安装中文语言包,双击或拖拽无效;安装后需手动执行 configure display language 并选 zh-cn,再重启 vscode 才生效。

必须用 Extensions: Install from VSIX 命令安装,双击或拖拽无效
VSCode 自 1.70 版起已禁用双击 .vsix 文件或拖拽进窗口的安装方式,这类操作只会把文件复制到 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows),但不会注册扩展 ID、不加载语言资源、也不写入启用状态。现象是:右下角仍显示 en,设置页和命令面板全英文,且无任何错误提示。
- 正确路径:按
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 回车 → 选中vscode-language-pack-zh-hans-*.vsix文件 → 点Install - 务必确认发布者为
MS-CEINTL,ID 为ms-ceintl.vscode-language-pack-zh-hans,其他名称或发布者的“中文包”基本无效 - 安装后打开扩展面板搜索该 ID,若未显示“已启用”,说明根本没注册成功,需先
Uninstall再重试
Configure Display Language 必须手动执行并选 zh-cn
装完 .vsix ≠ 界面变中文。VSCode 不会自动切换语言,必须显式触发语言协商流程。这个步骤常被跳过,导致前功尽弃。
- 按
Ctrl+Shift+P→ 输入Configure Display Language→ 选zh-cn(小写、短横线、不能是zh-hans、zh_CN或Chinese) - 点击弹出的
Restart按钮(不是Reload Window),否则语言环境不重建 - 若命令面板搜不到
Configure Display Language,说明插件未注册,回到上一步重装 - 不要手动改
settings.json加"locale": "zh-cn"—— 这个字段在那里不被识别;正确配置位置是locale.json,但命令面板方式已自动写入,无需手改
验证是否真生效,只看三处核心区域
别被终端输出、Git 提示、右下角状态栏“骗了”。这些组件不走 VSCode 的 locale 配置,即使全是英文也不代表语言包失败。
- 必须检查:顶部菜单栏(File / Edit / View…)、命令面板(
Ctrl+Shift+P中文提示)、设置导航栏(Settings 左侧分类如“用户”“工作区”“扩展”)——这三处全中文才算真正生效 - 若设置页仍是英文,大概率是用了
zh-hans(自 1.95+ 起仅加载部分字符串),或后台进程残留干扰 - Windows 上用任务管理器杀光所有
Code.exe;macOS/Linux 执行pkill -f "Code Helper"和pkill -f "Electron",再启动
远程开发环境需单独部署
本地装了中文包,对 SSH/WSL 远程窗口完全无效。远程机器是一个独立的 VSCode 实例,语言包必须在目标环境重复安装和配置。
- 点击右下角状态栏的
SSH: xxx→ 选择Install 'Chinese (Simplified) Language Pack' in SSH: xxx - 安装完成后,同样运行
Configure Display Language并选zh-cn→Restart - 若远程无图形界面(如纯 Linux 服务器),需手动确保
locale.json存在且内容为{"locale":"zh-cn"},路径为:
Linux 远程:~/.vscode-server/data/Machine/locale.json
Windows 远程:%USERPROFILE%\AppData\Roaming\Code\User\locale.json
.vsix 标明支持 "vscode": "^1.90.0",而你本地是 1.95.2,就可能静默失败;更常见的是旧进程卡住,让新配置压根不加载。











