必须用官方.vsix文件，禁用双击/拖拽安装；需通过命令面板执行“Extensions: Install from VSIX”安装后，再运行“Configure Display Language”选zh-cn并彻底重启，同时确保locale.json内容为{"locale":"zh-cn"}且杀净后台进程。
必须用官方 .vsix 文件，别碰 zip/tar/gz 压缩包
VSCode 中文包离线安装只认 .vsix 格式，不是任意压缩包。网上所谓“解压 language-pack.zip 后复制到 extensions 目录”的做法，99% 失效——因为 .vsix 本质是带签名和元数据的 ZIP，但 VSCode 启动时只加载已注册、已解压、有 .metadata 记录的扩展，手动扔文件夹进去等于没装。
常见错误现象：ms-ceintl.vscode-language-pack-zh-hans 在扩展面板里不显示、或显示“已禁用”、右下角语言始终是 en。
- 正确来源：只从微软官方发布页下载，地址形如
https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-ceintl/vsextensions/vscode-language-pack-zh-hans/1.104.2/vspackage - 验证方式：下载后右键 → 用 7-Zip 或系统归档工具打开，确认根目录下有
package.json，且其中"engines": {"vscode": "^1.104.0"}与你本地code --version输出的主版本号（如1.104.2→ 取1.104）严格匹配 - 别信“中文语言包合集”“一键汉化包.exe”“百度网盘压缩包”，那些大概率是旧版、篡改版或带静默行为的第三方封装
安装必须走 Extensions: Install from VSIX，双击或拖拽无效
VSCode 自 1.70 版起彻底禁用双击 .vsix 文件的安装机制。双击只是把文件复制到 %USERPROFILE%\.vscode\extensions\（Windows）或 ~/.vscode/extensions/（Linux/macOS），但不会注册扩展 ID、不触发资源加载、不写入激活状态——界面自然不变中文。
真正生效的操作路径只有一条：
- 在 VSCode 内按
Ctrl+Shift+X打开扩展面板 - 点右上角
⋯→ 选Install from VSIX... - 选中你传入的
MS-CEINTL.vscode-language-pack-zh-hans-1.104.2.vsix文件 - 安装完成后，**不要关窗口**，直接按
Ctrl+Shift+P输入Configure Display Language，选zh-cn，点“是”重载窗口
locale.json 必须严格写成 {"locale":"zh-cn"}，大小写和符号都不能错
装完插件、选了 zh-cn 还是英文？大概率是 locale.json 格式或位置错了。VSCode 主程序硬编码识别 "zh-cn"，其他写法全被忽略：
- ❌ 错误写法：
"zh_CN"、"ZH-CN"、"zh-hans"、"chinese"、"zh-cn "（末尾空格）、zh-cn（没双引号） - ✅ 正确写法：文件内容仅且仅有这一行：
{"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
装完重启仍无效？先杀干净后台进程再试
VSCode 的 Electron 架构常驻后台进程，即使关掉所有窗口，Code Helper 或 Electron 进程可能仍在运行，导致新配置不加载。
检查并清理方法：
- Windows：打开任务管理器 → 结束所有
Code.exe和Code Helper.exe进程 - macOS/Linux：终端执行
pkill -f "Code Helper"和pkill -f "Electron" - 再从「开始菜单」或「应用坞」重新启动 VSCode（别双击旧快捷方式，它可能指向卸载过的旧路径）
- 启动后立刻按
Ctrl+Shift+P→ 输入Developer: Show Running Extensions，确认ms-ceintl.vscode-language-pack-zh-hans状态为“已启用”
最易被忽略的是系统 locale 干预：Windows 若勾选了「Beta: Use Unicode UTF-8 for worldwide language support」且系统区域为 English (United States)，VSCode 会跳过语言包加载；macOS/Linux 下若 echo $LANG 输出 en_US.UTF-8，需临时设 LANG=zh_CN.UTF-8 再启 VSCode。
