离线安装VSCode中文语言包失败主因是版本不兼容或配置错误：需校验.vscode版本≥1.76、修改package.json中engines.vscode匹配本地版本、正确配置locale.json为{"locale":"zh-cn"}并彻底重启进程。
离线安装 VSCode 中文语言包卡在“Installing…”或报错，90% 不是文件损坏，而是 VSCode 在静默校验、路径解析或版本匹配环节失败——它不提示错误，只停住不动。
拖拽 .vsix 后卡在 “Installing…” 或无反应
图形界面依赖后台网络请求调度解压流程，断网时它不报错，只挂起或丢弃操作。
- 确认 VSCode 窗口有焦点：任务栏图标是否高亮？远程桌面（RDP/TeamViewer）下拖放常被拦截
- 检查文件是否真为
.vsix：用unzip -l ms-ceintl.vscode-language-pack-zh-hans-1.90.2.vsix看顶层是否有extension/package.json；若显示一堆零散文件，说明已被解压或损坏 - 路径含中文或空格？Windows 下必须用英文双引号包裹，如
"C:\my ext\ms-ceintl.vscode-language-pack-zh-hans-1.90.2.vsix" - 虚拟机共享文件夹（如
/mnt/hgfs）拖入常失败：先复制到本地路径（如~/Downloads/），再拖
code --install-extension 报 “not compatible with Code”
这不是签名问题，而是 package.json 中的 engines.vscode 字段与本地版本不满足语义化匹配规则。
- 运行
code --version获取当前版本（如1.96.3），取前三位（1.96.0）或完整版号均可 - 用
7-Zip或unzip解压.vsix，编辑extension/package.json - 将
"engines": {"vscode": "^1.90.0"}改为"engines": {"vscode": "1.96.3"}（填你本地完整版本号） - 重新打包为 ZIP，再把后缀改为
.vsix（注意：不是重命名，是改后缀；确保 ZIP 内结构不变）
装完仍是英文？关键在 locale.json 和进程重启
语言包装成功 ≠ 界面变中文。VSCode 必须同时加载资源 + 识别 locale 配置 + 启动干净进程。
- 配置文件路径必须是用户级：
%APPDATA%\Code\User\locale.json（Windows）、~/.config/Code/User/locale.json（Linux）、~/Library/Application Support/Code/User/locale.json（macOS） - 内容严格为一行：
{"locale":"zh-cn"}（小写、短横线、双引号、UTF-8 无 BOM 编码） - 别写成
zh_CN、zh-hans、Chinese或带空格的"zh-cn "，VSCode 会直接忽略 - 改完必须彻底退出所有 VSCode 进程（Windows 任务管理器杀掉
Code.exe和Code Helper；macOS 活动监视器搜Code；Linux 执行pkill -f "Code Helper"），再从开始菜单/应用坞启动
离线环境最易忽略的底层机制
中文包不是独立插件，它依赖 VS Code 内置的 vs/nls.js 模块做字符串替换。VS Code ≤1.75 默认不启用该模块，1.76+ 才默认注入。
- 如果你用的是老旧内网镜像源部署的 VS Code（比如企业 IT 统一推送的 1.72 版），即使装了最新语言包，也不会生效
- 确认 VS Code 版本 ≥1.76：终端运行
code --version，输出如1.76.0或更高才支持离线语言包自动加载 - 别信第三方汉化包（ID 不含
MS-CEINTL或不含zh-hans），它们在 1.85+ 后基本失效
