必须匹配vs code主版本号与语言包package.json中"engines.vscode"字段，如code --version输出1.104.2则需"^1.104.0"；离线安装须用命令面板extensions: install from vsix，再执行configure display language选zh-cn并彻底重启。
怎么确认本地 VS Code 版本和语言包是否匹配
离线安装失败，八成卡在这一步。VS Code 主程序和语言包有严格的版本兼容要求——不是“装上就能用”，而是必须满足 package.json 里 "engines": {"vscode": "^1.104.0"} 中的主版本号（前两位）与你本地 code --version 输出一致。
执行以下三步快速验证：
- 在终端运行
code --version，记下第一行输出，例如1.104.2→ 主版本是1.104 - 下载的
.vsix文件右键解压（它本质是 zip），打开里面的package.json - 检查
"engines"字段，确保其值为"^1.104.0"或类似（不能是^1.103.0或^1.105.0）
不匹配时，界面可能部分中文、设置页仍英文，或直接报 Extension is not compatible 却无提示。别硬试，去官网重下对应版本。
离线安装必须走 “Install from VSIX”，双击或拖拽无效
VS Code 自 1.70 起已禁用文件系统直加载机制。双击 .vsix 或拖进窗口，只会把文件复制到 ~/.vscode/extensions/ 目录，但不会注册扩展 ID、不触发语言资源加载，等于白放。
正确操作路径（全部在 VS Code 内完成）：
- 按
Ctrl+Shift+P打开命令面板 - 输入并选择
Extensions: Install from VSIX...（注意结尾有省略号） - 在弹出的系统文件对话框中，**手动定位并选中你的
.vsix文件**，点击 Install - 安装完成后，右下角若没弹
Restart Now，说明根本没注册成功——请打开扩展面板搜ms-ceintl.vscode-language-pack-zh-hans，确认状态是“已启用”
Configure Display Language 是激活开关，不是可选项
语言包只是“字典”，真正告诉 VS Code “用中文显示”的动作是 Configure Display Language 命令。它会生成或修正 locale.json，但只写配置、不刷新 UI。
常见错误现象：命令面板里搜不到这个命令 → 语言包压根没装成功；点了 zh-hans 或 ZH-CN → 配置被忽略；点了 Reload Window → 界面依旧英文。
必须严格按顺序操作：
- 按
Ctrl+Shift+P→ 输入Configure Display Language→ 回车 - 在下拉列表中**只选
zh-cn**（小写、连字符、无空格，zh_CN、Chinese、zh-hans全部无效） - 看到右下角弹出提示后，**点 Restart**（不是 Reload Window）
重启后若仍英文，请立刻检查 locale.json 文件内容是否为 {"locale":"zh-cn"}，且保存为 UTF-8 无 BOM 编码。
重启不生效？先杀干净后台进程再试
VS Code 的 Electron 架构会在后台残留 Helper 进程，哪怕关掉所有窗口，locale.json 的新配置也不会被读取。这是离线环境最常被忽略的一环。
不同系统清理方式：
- Windows：打开任务管理器 → 结束所有名为
Code.exe和Code Helper.exe的进程 - macOS：终端执行
pkill -f "Code Helper"和pkill -f "Electron" - Linux：同 macOS，或用
killall code（若支持）
做完这步再从「开始菜单」或「应用坞」全新启动 VS Code —— 不要用旧快捷方式，它可能指向已卸载的老版本路径。如果系统 locale 是 en_US.UTF-8，macOS/Linux 用户还需临时加一句 export LANG=zh_CN.UTF-8 再启。
