离线安装vscode中文包必须通过命令面板执行“extensions: install from vsix”，双击或拖拽无效；安装后需将locale.json中locale设为"zh-cn"并彻底重启。
离线安装必须用 Extensions: Install from VSIX 命令
双击 .vsix 文件或拖进 VSCode 窗口，从 VSCode 1.70 开始已失效——它会静默失败，不报错、不提示、不注册扩展，只把文件丢进 ~/.vscode/extensions/ 目录里躺着。真正能触发安装流程的，只有命令面板里的 Extensions: Install from VSIX。
操作路径：Ctrl+Shift+P → 输入并执行 Extensions: Install from VSIX → 选中下载好的 MS-CEINTL.vscode-language-pack-zh-hans-*.vsix → 点 Install。
常见错误现象包括：右下角状态栏仍显示 en、设置页/调试面板全英文、重启多次无变化——基本就是卡在这一步没走对。
locale.json 必须设为 "zh-cn"，不是 "zh-hans" 或 "zh"
语言包装好只是“备好了字典”，VSCode 默认仍以英文启动。切换界面语言靠的是 Configure Display Language 命令，它会修改 locale.json 文件里的 "locale" 字段值。
这个值必须是 "zh-cn"（小写、带连字符），不能是 "zh-hans" 或 "zh"：
-
"zh-hans"在部分新版 VSCode（如 1.95+）中仅加载部分 UI 资源，设置页、终端标题栏可能仍是英文 -
"zh"不符合 BCP 47 标准，VSCode 主程序不识别，fallback 到英文 - 该配置若出现在工作区
.vscode/settings.json中，会覆盖全局设置，需一并检查并清理
改完保存后，必须彻底退出所有 VSCode 进程再重启——仅“重载窗口”不生效。
离线包来源和版本匹配是硬门槛
官方简体中文语言包只有一个 ID：ms-ceintl.vscode-language-pack-zh-hans，发布者必须是 MS-CEINTL。任何名字相似但发布者不是它的插件（比如 “Chinese Language Pack” 发布者为 “abc123”），都是仿冒或旧版，不兼容当前 VSCode。
下载路径唯一可信来源：https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-zh-hans
拉到页面底部点 Download Extension，得到形如 MS-CEINTL.vscode-language-pack-zh-hans-1.95.1.vsix 的文件。
版本不匹配会直接失败：
- 用 v1.92 的
.vsix安装到 v1.95+ 的 VSCode，可能报Extension is not compatible，也可能静默失败 - Stable 和 Insiders 版本语言包不通用，给 Stable 装了，Insiders 启动仍是英文，属正常行为
- 企业内网若禁用
file://协议，Install from VSIX可能被拦截，需协调安全策略
code --install-extension 命令对路径很敏感
命令行安装看似方便，但实际容易翻车：
- 路径含中文或空格（如
C:\Users\张三\Desktop\zh-hans.vsix）会报ENOENT: no such file or directory -
code命令本身未加入 PATH 时，先在 VSCode 里运行Shell Command: Install 'code' command in PATH - Windows 上旧 CMD/PowerShell 进程不会自动继承新 PATH，需新开终端；macOS/Linux 需执行
source ~/.zshrc刷新环境 - 验证是否成功：
code -v能输出版本号才算就位
真正卡住人的从来不是“找不到包”，而是装完没重启、locale.json 被工作区覆盖、或者 code 命令根本没生效——这些环节任一出错，界面就永远停在英文。
