离线安装vscode中文语言包必须通过命令面板执行“extensions: install from vsix”，双击或拖拽无效；需下载官方vscode-language-pack-zh-hans插件，安装后运行“configure display language”选zh-cn并重启，且locale.json须为{"locale":"zh-cn"}（小写连字符、utf-8无bom），同时彻底退出vscode后台进程。
离线安装必须用“Install from VSIX”，不是双击或拖拽
VSCode 自 1.70 版起已禁用文件系统直接加载机制。双击 .vsix 文件、拖进窗口、甚至用 code --install-extension 命令行，都可能静默失败——它只会把文件复制到 ~/.vscode/extensions/（Linux/macOS）或 %USERPROFILE%\.vscode\extensions\（Windows），但不注册扩展 ID、不触发语言资源加载流程。现象是：扩展面板里搜不到 ms-ceintl.vscode-language-pack-zh-hans，右下角仍显示 en，设置页和命令面板全是英文，且无任何报错提示。
真正生效的路径只有一条：通过命令面板执行 Extensions: Install from VSIX。这个操作会走 VSCode 内置安装器，完成解压、注册、写入激活状态、触发资源加载全流程。
下载的 .vsix 必须来自微软官方且版本匹配
别信百度网盘、第三方镜像站或名字含“汉化”“中文支持”的压缩包——它们要么过期，要么被篡改，要么根本不是 ms-ceintl.vscode-language-pack-zh-hans 这个 ID。
- 正确来源只有两个：
https://github.com/microsoft/vscode-loc/releases（找vscode-language-pack-zh-hans的最新 release）或微软扩展市场页面点击 Download Extension 按钮 - 下载后右键解压
.vsix（它本质是 zip），打开里面的package.json，确认"engines": {"vscode": "^1.xx.x"}和你本地code --version输出的主版本号一致（比如输出1.104.2，就得匹配^1.104.0） - 别用
chinese-language-pack或作者是个人 ID 的包，它们不更新、不兼容新版，有些还会覆盖locale.json导致命令面板空白
装完不生效？检查 locale.json 和后台进程
安装成功 ≠ 界面变中文。90% 的“不生效”问题出在配置没落到位或残留进程干扰。
-
locale.json必须严格为{"locale":"zh-cn"}（小写、连字符、双引号、UTF-8 无 BOM 编码），不能是zh_CN、zh-hans、Chinese或带空格的"zh-cn " - 文件路径要放对：
Windows：%APPDATA%\Code\User\locale.json
macOS：$HOME/Library/Application Support/Code/User/locale.json
Linux：$HOME/.config/Code/User/locale.json - 启动前必须杀干净所有后台进程：
Windows：任务管理器中结束全部Code.exe
macOS/Linux：pkill -f "Code Helper"和pkill -f "Electron"
Configure Display Language 命令搜不到？说明语言包根本没装对
这个命令是激活中文的开关，不是“装完即用”。它本质是生成或修正 locale.json，但只写配置、不刷新 UI。如果命令面板里搜不到 Configure Display Language，基本可以断定：语言包没装成功，或者装了但没启用。
验证方式很简单：打开扩展面板，搜索 ms-ceintl.vscode-language-pack-zh-hans，看是否显示“已启用”。若未显示，先点右上角 ⋯ → Uninstall，再走命令面板重走一遍 Extensions: Install from VSIX 流程。
真正容易被忽略的是：即使 locale.json 写对了，如果 VSCode 启动时读到了旧版残留的 settings.json 中错误的 "locale" 字段（比如 "zh-Hans"），也会覆盖掉它。批量部署或反复调试失败后，建议手动删掉 settings.json 里的 locale 行，只留 locale.json 单点控制。
