必须从官网直链https://www.php.cn/link/60f79dfd80ed019c1c155704b89568bc下载正版.vsix，核验ID为ms-ceintl.vscode-language-pack-zh-hans、发布者为Microsoft，解压检查package.json中engines.vscode版本匹配，再通过命令面板“Extensions: Install from VSIX”安装，并确保locale.json为{"locale":"zh-cn"}且彻底重启。
怎么下载到真正能用的官方中文包
必须从 Visual Studio Code 官方市场直链下载 vscode-language-pack-zh-hans，其他任何来源（百度网盘、第三方镜像、GitHub Release 页面）都不可靠。关键看发布者 ID：只有 ms-ceintl.vscode-language-pack-zh-hans 这个 ID 且发布者是 Microsoft 的才是正版。
正确做法是打开官网插件页：https://www.php.cn/link/60f79dfd80ed019c1c155704b89568bc，拉到页面最底部，点 Download Extension 按钮——它生成的是带签名的直链，不会 404，也不会下错版本。
下载后文件名形如 MS-CEINTL.vscode-language-pack-zh-hans-1.104.2025082016.vsix，右键解压（.vsix 就是 zip），打开里面的 package.json，确认 "engines": {"vscode": "^1.104.0"} 和你本地 code --version 输出的第一段主版本号一致（比如输出 1.104.2，就匹配 ^1.104.0）。
为什么不能双击或拖拽 .vsix 文件
VS Code 自 1.70 版起已禁用双击/拖拽安装机制。这么做只是把文件复制进 ~/.vscode/extensions/（Linux/macOS）或 %USERPROFILE%\.vscode\extensions\（Windows），但不注册扩展 ID、不触发语言资源加载流程，也不写入激活状态。
现象是：扩展面板里搜不到 ms-ceintl.vscode-language-pack-zh-hans，或显示“未启用”；右下角状态栏仍为 en；设置页、命令面板、调试视图全英文，且无任何报错提示。
根本原因：VS Code 主程序只认通过内置安装器注册的语言包。离线环境唯一有效路径是命令面板调用 Extensions: Install from VSIX，别无他法。
怎么验证 .vsix 文件是否适配当前环境
除了版本号匹配，还要检查架构和系统 locale 干预风险：
- ARM Mac 用户必须下载含
darwin-arm64的文件名，x64 版本装上会报Extension is not compatible且静默失败 - Windows 上若系统区域设为
English (United States)并勾了Beta: Use Unicode UTF-8 for worldwide language support，VS Code 会跳过语言包加载 - macOS/Linux 下运行
echo $LANG，若输出en_US.UTF-8，需临时执行export LANG=zh_CN.UTF-8再启动 VS Code 才能触发中文资源加载 - 别信插件页面写的“Compatible with VS Code 1.90+”，要以
package.json中的engines.vscode字段为准
离线部署前必须清理的配置残留
装错包或多次尝试后，settings.json 或 locale.json 可能已写入错误字段，导致后续安装始终不生效：
手动删掉这些内容：
-
settings.json里所有"locale": "zh-CN"、"locale": "zh_hans"、"locale": "Chinese"等非法值（只认小写连字符格式"zh-cn"） - 如果之前用第三方“汉化插件”，它们可能覆盖了
locale.json结构，直接删掉整个locale.json文件更稳妥 - 确保最终生效的
locale.json严格为单行：{"locale":"zh-cn"}，UTF-8 编码、无 BOM、无多余空格或逗号
配置文件路径必须准确：
Windows：%APPDATA%\Code\User\locale.json
macOS：$HOME/Library/Application Support/Code/User/locale.json
Linux：$HOME/.config/Code/User/locale.json
真正麻烦的不是下载或安装，而是旧配置、后台进程、系统 locale 三者叠加造成的“看起来装好了却没反应”。每次重试前，先杀干净所有 Code.exe（Windows）、Electron（macOS）或 code（Linux）进程，再全新启动。
