必须安装ms-ceintl.vscode-language-pack-zh-hans官方插件,下载后解压校验package.json中vscode版本匹配,安装后执行configure display language设locale为"zh-cn"并彻底重启。

直接装官方中文包,别信第三方“汉化插件”
VSCode 界面汉化只认一个插件:MS-CEINTL.vscode-language-pack-zh-hans。其他名字类似、发布者不是 MS-CEINTL 的,基本是旧版、仿冒或阉割包,装了也切不出中文。
验证方式很简单:下载下来的 .vsix 文件右键解压(它本质是 zip),打开里面的 package.json,检查 "engines": {"vscode": "^1.90.0"} 里的版本号,和你本地运行 code --version 输出的第一段(如 1.90.2 → 取 1.90)是否匹配。
- 不匹配?换对应 VS Code 版本的 vsix,官网 Releases 页面按 tag 筛选
- 发布者不是
MS-CEINTL?删掉,重下 - 文件名含
darwin-arm64或win32-x64?说明架构对得上;没标就可能是错的
命令行安装失败,先查三件事
code --install-extension 报错,90% 和网络无关,而是路径、权限或环境问题。
-
ENOENT: no such file or directory:路径含中文、空格或特殊符号(如C:\Users\张三\Desktop\zh.vsix)→ 改用纯英文路径,例如C:\vsix\zh.vsix -
command not found: code:终端找不到code命令 → 在 VS Code 里按Ctrl+Shift+P,输入Shell Command: Install 'code' command in PATH并执行 -
Extension is not compatible:不是版本错,是架构错 → ARM Mac 装了 x64 版本 vsix,必须核对文件名是否含darwin-arm64
装完还是英文?重启只是第一步
安装后不生效,多数卡在启动方式或配置冲突上,不是插件没装成。
- 别双击旧快捷方式:它可能指向已卸载的老版本 VS Code 目录;改从「开始菜单」或「应用坞」重新打开
- Windows 上若系统区域设为
English (United States)并勾了「Beta: Use Unicode UTF-8…」,会跳过语言包;macOS/Linux 检查echo $LANG,如果是en_US.UTF-8就得手动干预 -
settings.json里删掉任何硬编码的"locale": "en"或"locale": "zh-CN"—— 正确格式只认小写连字符:"locale": "zh-cn",多一个大写或下划线都失效
内网批量部署时,漏掉这步等于白装
只拷 .vsix 文件过去,等于只送了“安装包”,没送“弹药”。语言包要生效,还得走一遍 Configure Display Language 流程。
自动化脚本里必须包含这一步:code --locale=zh-cn 启动,或通过命令面板调用 Configure Display Language 并选 zh-cn,再彻底退出进程(不能只关窗口)。否则新用户首次启动仍是英文,且不会自动弹出语言切换提示。
真正容易被忽略的是:语言包加载依赖 VS Code 启动时读取的 locale 配置和用户数据目录结构,而这两者在干净重装或跨用户部署时极易错位。











