VSCode离线安装语言包失败怎么解决-VSCode-PHP中文网

离线安装vscode中文语言包失败，90%是因引擎版本不匹配、locale.json配置错误或未通过命令面板安装；必须解压修改package.json中engines.vscode为本地精确版本号，配置用户级locale.json为{"locale":"zh-cn"}，并执行extensions: install from vsix后彻底重启。

vscode离线安装语言包失败怎么解决

离线安装 VSCode 中文语言包失败，90% 不是文件坏了，而是 VSCode 在扩展注册、引擎版本匹配或 locale 配置加载环节静默跳过——它不报错，只“假装装上了”。

为什么双击或拖拽 .vsix 文件完全没反应

VSCode 自 1.70 版起已禁用直接文件系统加载机制。双击/拖拽只是把文件复制到 ~/.vscode/extensions/（Linux/macOS）或 %USERPROFILE%\.vscode\extensions\（Windows），但不会注册扩展 ID、不触发 nls 资源加载、也不写入启用状态。

验证方式：打开扩展面板，搜 ms-ceintl.vscode-language-pack-zh-hans，若没显示“已启用”，说明根本没注册
唯一可靠路径：按 Ctrl+Shift+P → 输入 Extensions: Install from VSIX → 选中官方下载的 vscode-language-pack-zh-hans-*.vsix
别用浏览器直接另存为——必须从 Marketplace 页面点 “Download Extension” 拿到原始 .vsix

安装后界面仍是英文？关键在 locale.json 和重启方式

装上 ≠ 生效。VSCode 1.70+ 只认用户级 locale.json 里的 {"locale":"zh-cn"}，其他任何地方写的都无效。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

文件路径必须准确：
Linux：~/.config/Code/User/locale.json
Windows：%APPDATA%\Code\User\locale.json
macOS：~/Library/Application Support/Code/User/locale.json
内容必须严格为 UTF-8 无 BOM 编码的 JSON：{"locale":"zh-cn"}（小写、短横线、双引号，冒号后有空格）
别写成 zh_CN、zh-hans、Chinese 或带空格的 "zh-cn "，VSCode 会直接忽略
执行 Configure Display Language 命令并选 zh-cn 后，必须点 Restart —— 关闭再手动打开不算，后台 Code Helper 进程必须彻底退出

报 “not compatible with the current version of VS Code” 怎么修

这不是签名问题，而是 package.json 里 "engines": {"vscode": "^1.90.0"} 和你本地 code --version 输出（如 1.96.3）不满足语义化匹配规则。

先解压 .vsix：unzip -l your.vsix 确认根目录含 extension/package.json
用 7-Zip 或 unzip -p your.vsix extension/package.json | grep engines 查看当前字段
编辑该文件，把 "vscode": "^1.90.0" 改成 "vscode": "1.96.3"（填你本地完整版本号）
重新打包为 ZIP，再改后缀为 .vsix（注意：不是重命名，是改后缀；结构不能破坏）
Windows 下别用资源管理器双击解压再压缩——会破坏 ZIP 结构，导致静默失败

远程开发（SSH/WSL）环境单独失效

本地装了中文包，对 Remote 窗口完全无效。Remote-SSH / WSL 启动的是独立的 vscode-server 实例，读的是远程机器自己的配置。

必须在远程终端执行：code --install-extension vscode-language-pack-zh-hans.vsix
再进远程 ~/.vscode-server/data/Machine/（后面带哈希名的子目录），新建或编辑 locale.json，内容仅 {"locale":"zh-cn"}
远程窗口中按 Ctrl+Shift+P → Developer: Reload Window（不是本地窗口！）
如果 ~/.vscode-server/data/Machine/ 下没有子目录，说明 server 没跑起来，先开个远程文件夹再试