离线安装vscode中文包首选命令面板+vsix路径:先用extensions: install from vsix安装,再configure display language选zh-cn并restart;code --install-extension因path、路径、版本等敏感易失败,仅适合验证或批量部署。

离线安装 VSCode 中文包,code --install-extension 命令本身不可靠——它在多数内网或权限受限环境中会静默失败,不是首选方案;真正能落地的方式仍是命令面板 + .vsix 文件路径,命令行仅作辅助验证和批量部署场景的补充。
为什么 code --install-extension 经常不生效
这个命令对路径、环境变量、VSCode 版本三者极其敏感,常见失效原因包括:
-
code命令未加入系统 PATH:即使安装时勾选了“Add to PATH”,某些企业镜像版或手动解压版默认不写入,需先在 VSCode 中执行Shell Command: Install 'code' command in PATH - 路径含中文、空格或特殊符号(如
C:\Users\张三\Downloads\zh.vsix)→ 必须改用纯英文绝对路径,例如C:\vsix\zh.vsix - 终端当前工作目录不是
.vsix所在目录,又没写全路径 → 一定要用绝对路径调用,不能只写文件名 - VSCode 正在运行且有窗口打开 → 命令可能被忽略,必须先彻底关闭所有
Code.exe或Electron进程
正确使用 code --install-extension 的前提条件
仅当满足以下全部条件时,该命令才大概率成功:
- 本地
code --version输出的版本号(如1.104.2)与.vsix文件名中版本段(如vscode-language-pack-zh-hans-1.104.2025082016.vsix)匹配,且package.json中"engines": {"vscode": "^1.104.0"}兼容 -
.vsix是从官网下载的正版包,发布者为MS-CEINTL,ID 为ms-ceintl.vscode-language-pack-zh-hans - 已确认
code命令可执行(终端输入code --help有响应) - 所有 VSCode 进程已终止,Windows 用任务管理器杀光
Code.exe,macOS/Linux 执行pkill -f "Code Helper"和pkill -f Electron
装完之后必须做的两件事,缺一不可
命令行安装只是把扩展注册进系统,不等于界面变中文。接下来必须手动激活语言配置:
- 启动 VSCode,按
Ctrl+Shift+P输入Configure Display Language(注意大小写和空格,不能缩写),回车后明确选择zh-cn(小写、短横线、无引号) - 弹出提示后,必须点
Restart(不是Reload Window),否则语言资源不会加载 - 若命令面板搜不到
Configure Display Language,说明.vsix根本没注册成功,此时应放弃命令行方式,改用命令面板的Extensions: Install from VSIX重试
更稳妥的替代方案:用命令面板走 Install from VSIX
对绝大多数离线环境来说,这条路径成功率接近 100%,且无需依赖 code 命令:
- 将
.vsix文件拷贝到目标机器任意位置(如~/Downloads/) - 启动 VSCode →
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 回车 - 在弹出的文件选择框中定位并选中该
.vsix文件 → 点击Install - 安装完成后立即执行
Configure Display Language→ 选zh-cn→Restart
关键细节:不要双击或拖拽 .vsix 文件进窗口,VSCode 自 1.70 起已禁用该机制,静默失败且无提示——这是最容易被忽略、也最常导致“明明装了却还是英文”的根源。











