离线安装VSCode中文包必须通过命令面板执行“Extensions: Install from VSIX”,因VS Code 1.70+已禁用双击、拖拽及code --install-extension等路径;该入口能完整执行注册、解压、资源挂载与ID写入,其他方式仅落盘文件而不激活。

离线安装 VSCode 中文包,Extensions: Install from VSIX 是唯一可靠入口,双击 .vsix 文件、拖拽进窗口、或用 code --install-extension 命令行调用,都可能静默失败——不是操作错了,而是 VSCode 自 1.70 起已禁用这些路径。
为什么双击或拖拽 .vsix 文件不生效
VSCode 不再把双击/拖拽当作安装行为,只当普通文件复制:它会把 .vsix 文件原样存进 ~/.vscode/extensions/(Linux/macOS)或 %USERPROFILE%\.vscode\extensions\(Windows),但不会注册扩展 ID、不触发语言资源加载、也不写入启用状态。现象是右下角仍显示 en,设置页、命令面板、调试视图全英文,且无任何提示。
- 验证是否真安装成功:打开扩展面板(
Ctrl+Shift+X),搜索ms-ceintl.vscode-language-pack-zh-hans,必须显示“已启用”状态 - 若没出现或显示“已禁用”,说明只是文件落盘,未激活
- 不要手动解压 .vsix 后复制文件夹进去——缺少
.metadata注册记录,VSCode 启动时直接跳过
必须用命令面板走 Install from VSIX
这是目前唯一被 VSCode 主程序认可的离线安装通道,它会完整执行注册、解压、资源挂载、ID 写入全流程。
- 先在联网设备下载正版:官网页面 → 拉到底部点
Download Extension→ 得到形如MS-CEINTL.vscode-language-pack-zh-hans-1.104.2025082016.vsix的文件 - 复制到目标机器任意路径(如
C:\vsix\或~/Downloads/) - 在目标机 VSCode 中按
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 回车 → 选中该 .vsix 文件 → 点Install - 安装完成后不要关窗口,立刻再按
Ctrl+Shift+P→ 输入Configure Display Language→ 选zh-cn(小写、短横线、无空格)→ 点Restart(不是 Reload Window)
locale 配置必须是 "zh-cn",且不能写在 settings.json 里
settings.json 中加 "locale": "zh-cn" 完全无效——这个字段自 2026 年起已被弃用,VSCode 不识别。真正起作用的是用户级 locale.json 文件,且格式极其敏感。
- 文件路径必须准确:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
~/.config/Code/User/locale.json
- Windows:
- 内容严格为单行 JSON:
{"locale":"zh-cn"}(UTF-8 无 BOM,双引号、小写、短横线,不能有注释或换行) -
zh-hans在 1.95+ 版本中仅加载部分 UI 字符串,设置页、终端、调试面板仍为英文;zh_CN、Chinese、zh全部不匹配,会被忽略
安装后仍不生效?重点检查后台残留和版本兼容性
多数“装了没反应”问题与插件本身无关,而是环境干扰导致语言协商链断裂。
- 后台进程未彻底退出:Windows 用任务管理器杀光所有
Code.exe;macOS/Linux 运行pkill -f "Code Helper"和pkill -f "Electron",再启动 - 语言包版本不匹配:解压 .vsix 后打开
package.json,检查"engines": {"vscode": "^1.104.0"};运行code --version,取前两位(如1.104.2→1.104),必须 ≥ 插件要求的最低主版本 - 系统 locale 干预:Windows 若勾了「Beta: Use Unicode UTF-8…」且区域设为 English,VSCode 会跳过语言包;macOS/Linux 下
echo $LANG若为en_US.UTF-8,需临时改export LANG=zh_CN.UTF-8再启 VSCode
最关键的遗漏点往往不是步骤漏了,而是重启时没彻底杀掉后台进程,或者 locale.json 放错路径、多了一个空格、用了中文引号——VSCode 对这个文件的解析是零容错的。


















