vs code离线安装中文语言包必须使用官方插件ms-ceintl.vscode-language-pack-zh-hans,避免第三方仿冒或旧版vsix;安装后不生效需检查启动方式、系统locale及settings.json中locale配置;命令行安装时路径须为纯英文;stable与insiders版本语言包不通用,需匹配对应版本下载。

VS Code 离线安装中文语言包要找对插件名
VS Code 官方中文语言包只有一个:Chinese (Simplified) Language Pack for Visual Studio Code。离线安装失败,90% 是因为装了第三方仿冒插件(比如叫“Chinese Language Pack”但发布者不是 MS-CEINTL),或者下载的是旧版 VSIX 文件(不兼容当前 VS Code 版本)。
正确做法:
- 打开 VS Code 官网扩展页:https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-zh-hans
- 拉到页面底部,点「Download Extension」——它会直接下载一个 .vsix 文件,名字类似 MS-CEINTL.vscode-language-pack-zh-hans-1.90.2.vsix
- 不要用百度搜“vscode汉化包下载”,那些网盘链接大概率是过期或夹带的
离线安装后不生效?检查 VS Code 启动方式和 locale 设置
装完 .vsix 文件,重启 VS Code 还是英文,常见原因有三个:
- 你双击打开的是旧版快捷方式(指向老路径),实际启动的是未更新的 VS Code 实例;建议从开始菜单或应用坞里重新打开
- VS Code 被系统 locale 强制覆盖:Windows 上若系统区域设为“英语(美国)”,且勾选了“Beta: Use Unicode UTF-8 for worldwide language support”,可能跳过语言包;macOS/Linux 下检查
LANG环境变量是否为en_US.UTF-8类值 - 配置项
locale被手动写死:打开settings.json,删掉类似"locale": "en"这行;VS Code 会自动 fallback 到系统语言 + 已安装语言包
用命令行安装 .vsix 时路径含空格或中文会报错
VS Code 的 code --install-extension 命令对路径很敏感。如果你把 .vsix 文件放在桌面(如 C:\Users\张三\Desktop\zh-hans.vsix),直接运行会失败,报错类似:ENOENT: no such file or directory。
安全做法:
- 把 .vsix 文件移到纯英文路径下,例如 C:\vsix\zh-hans.vsix
- 在终端中执行:code --install-extension C:\vsix\zh-hans.vsix
- 如果提示 command not found: code,先在 VS Code 里按 Ctrl+Shift+P,输入 Shell Command: Install 'code' command in PATH 并运行
多版本共存时语言包不通用
VS Code Insiders 和 Stable 版本的扩展不互通。你给 Stable 版装了中文包,Insiders 启动还是英文——这是正常行为,不是 bug。
对应关系要盯紧:
- Stable 版(官网下载的蓝色图标)→ 安装对应 Stable 的 .vsix(版本号通常匹配 1.x)
- Insiders 版(绿色图标)→ 必须去 https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-zh-hans&ssr=false#version-history 找带 insider 标签的版本下载
- 如果混用,VS Code 会静默忽略该扩展,不会报错也不会提示
离线部署最麻烦的从来不是下载,而是确认 VS Code 构建版本和语言包版本的 ABI 兼容性——这点连很多企业 IT 都会漏掉










