必须安装微软官方语言包 MS-CEINTL.vscode-language-pack-zh-hans,校验 .vsix 版本兼容性,避免路径含中文/空格,清除 settings.json 中 locale 配置,并确保 code 命令加入 PATH。

中文语言包必须用 MS-CEINTL.vscode-language-pack-zh-hans
其他名字、发布者或后缀(如 chinese-lang-pack、vscode-chinese、Chinese (Simplified) Language Pack 等)基本无法真正切换界面语言,装了也白装。只有 MS-CEINTL.vscode-language-pack-zh-hans 是微软官方维护的唯一有效 ID,对应插件页面地址固定为:https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-zh-hans
离线安装前务必校验 .vsix 版本兼容性
下载的 .vsix 文件本质是 zip 包,解压后打开 package.json,检查 "engines": {"vscode": "^1.90.0"} 中的版本号前两位(如 1.90)是否与本地 VS Code 版本匹配:
- 运行
code --version查看输出第一段(例如1.90.2→ 兼容^1.90.0) - Stable 与 Insiders 版本的语言包不通用,别混用
- 版本不匹配会静默失败,无报错提示,只表现为重启后仍是英文
命令行安装失败最常见的三个原因
code --install-extension 对路径极其敏感,容易因以下情况报 ENOENT: no such file or directory:
- 路径含中文或空格(例如
C:\Users\张三\Desktop\zh.vsix)→ 改到纯英文路径,如C:\vsix\zh.vsix -
code命令未加入系统 PATH → 在 VS Code 中按Ctrl+Shift+P,输入并执行Shell Command: Install 'code' command in PATH - 终端当前目录不是 vsix 所在目录,又没写全路径 → 必须用绝对路径调用,例如:
code --install-extension C:\vsix\zh.vsix
settings.json 里残留的 locale 配置会覆盖插件效果
如果之前手动改过语言设置,settings.json 中可能有类似这样的配置:
"locale": "en"
这类配置优先级高于语言包,会导致中文包失效。解决方法:
- 按
Ctrl+Shift+P输入Preferences: Open Settings (JSON) - 删掉所有含
"locale"的行(包括注释里的) - 重启 VS Code,让语言包自动接管
- 如需强制指定,应使用
Configure Display Language命令,而非手写locale
最易被忽略的是:系统区域设置(Windows 设置 → 时间和语言 → 区域)若设为非中文,有时会干扰首次启动行为;但只要 MS-CEINTL 插件正确安装且 settings.json 干净,这个影响基本可控。


















