离线安装vscode中文包必须通过命令面板执行“extensions: install from vsix”，再运行“configure display language”并选zh-cn后彻底重启；双击或拖拽.vsix文件无效，因vscode 1.70+已禁用该机制，仅复制文件而不注册扩展id或加载资源。
离线安装必须用 Extensions: Install from VSIX 命令
双击 .vsix 文件或拖拽进 VSCode 窗口，99% 无效——VSCode 自 1.70 版起已禁用该机制，静默失败且无提示。它只会把文件复制到 ~/.vscode/extensions/（Linux/macOS）或 %USERPROFILE%\.vscode\extensions\（Windows），但不注册扩展 ID、不加载语言资源。
- 正确路径：按
Ctrl+Shift+P→ 输入Extensions: Install from VSIX→ 回车 → 选中下载好的vscode-language-pack-zh-hans-*.vsix - 必须认准发布者是
MS-CEINTL，ID 是ms-ceintl.vscode-language-pack-zh-hans；名字含“汉化”“中文支持”的第三方插件一律不碰 - 装完后打开扩展面板（
Ctrl+Shift+X），搜ms-ceintl.vscode-language-pack-zh-hans，确认状态为“已启用”
Configure Display Language 必须手动执行并选 zh-cn
装完 .vsix ≠ 界面变中文。这一步才是激活开关，它会生成或修正 locale.json，但只写配置、不刷新 UI。
- 按
Ctrl+Shift+P→ 输入完整命令名Configure Display Language（注意大小写和空格） - 在下拉列表中明确选
zh-cn（小写、短横线、不能写成zh_CN、zh-hans或Chinese） - 弹出提示后点
Restart（不是Reload Window）；若没弹提示，检查后台进程是否残留：Windows杀光所有Code.exe，macOS/Linux执行pkill -f "Code Helper"和pkill -f "Electron"
locale.json 手动配置仅作备用，格式必须严格
命令面板搜不到 Configure Display Language，或反复失败时，可手动写 locale.json，但仅限补救，且容错率极低。
- 路径必须准确：
Linux：~/.config/Code/User/locale.json
Windows：%APPDATA%\Code\User\locale.json
macOS：$HOME/Library/Application Support/Code/User/locale.json - 内容严格为：
{"locale":"zh-cn"}（UTF-8 编码、无 BOM、无多余空格、无注释） - 不要在
settings.json里加"locale": "zh-cn"—— 这个字段在那里不被识别
远程开发需在目标环境单独部署
本地装了中文包，对 SSH 或 WSL 远程窗口完全无效。远程机器上必须重复两步：Install from VSIX + Configure Display Language。
- 操作路径：点击右下角状态栏的
SSH: xxx→ 选Install 'Chinese (Simplified) Language Pack' in SSH: xxx - 安装完成后，仍需在远程窗口中运行
Configure Display Language并选zh-cn→ 再点Restart - 若远程无图形界面，确保
locale.json已按上述路径和格式写入，且 VSCode Server 版本与语言包兼容（比如vscode-language-pack-zh-hans-1.104.*.vsix要匹配code --version输出的主版本）
Code.exe 还在后台跑，或者 .vsix 的 engines.vscode 不匹配当前 VSCode 主版本，就会静默失效。
