必须用 extensions: install from vsix，双击或拖拽 .vsix 文件无效；vscode 自 1.70 起禁用该方式，文件仅被复制但未注册，界面仍为英文；正确流程是：ctrl+shift+p → 输入 extensions: install from vsix → 选包安装 → 再执行 configure display language 选 zh-cn → 点 restart；还需确保 locale.json 正确写入 {"locale":"zh-cn"} 并彻底终止后台进程后重启。
必须用 Extensions: Install from VSIX，双击 .vsix 文件无效
VSCode 自 1.70 版起已禁用双击或拖拽安装机制，文件只会被复制到 ~/.vscode/extensions/（Linux/macOS）或 %USERPROFILE%\.vscode\extensions\（Windows），但不会注册扩展 ID、不加载语言资源、也不出现在已启用列表里。现象是：右下角仍显示 en，设置页和命令面板全英文，且无任何错误提示。
正确路径只有一条：Ctrl+Shift+P → 输入 Extensions: Install from VSIX → 回车 → 选中提前下载好的 vscode-language-pack-zh-hans-*.vsix（发布者必须为 MS-CEINTL，ID 必须是 ms-ceintl.vscode-language-pack-zh-hans）→ 点 Install。
- 别用
code --install-extension xxx.vsix命令行方式——在离线或某些权限受限环境下常静默失败 - 别从第三方网盘、压缩包合集、exe 封装器下载 .vsix——签名不匹配或版本过期会导致“Extension is not compatible”提示（有时甚至不提示）
- 验证是否真装成功：打开扩展面板（
Ctrl+Shift+X），搜索ms-ceintl.vscode-language-pack-zh-hans，确认状态为“已启用”
Configure Display Language 必须手动执行，且只能选 zh-cn
语言包只是翻译字典，VSCode 默认仍按英文启动。真正触发中文界面的是 Configure Display Language 这个内置命令，它不自动运行，也不随安装完成而触发。
操作步骤：Ctrl+Shift+P → 输入 Configure Display Language → 回车 → 在弹出列表中**明确选择 zh-cn**（小写、短横线、无空格；zh_CN、zh-hans、Chinese 全部无效）→ 点提示框里的 Restart（不是 Reload Window）。
- 如果命令面板搜不到
Configure Display Language，说明语言包根本没注册成功，重走上一步安装流程 -
zh-hans在 VSCode 1.95+ 中仅加载部分 UI 字符串，设置页、调试面板、终端视图仍为英文 - 不要手动往
settings.json里加"locale": "zh-cn"—— 这个字段在 settings.json 中完全不被识别
locale.json 手动写入是最稳的兜底方案
当命令面板卡死、UI 崩溃、或批量部署时，直接编辑 locale.json 是最可靠的方式。VSCode 启动时优先读取该文件，且它的生效优先级高于 settings.json。
操作前务必彻底关闭所有 VSCode 进程：
– Windows：任务管理器杀光所有 Code.exe
– macOS：活动监视器杀掉 Electron 及 Code Helper
– Linux：运行 pkill -f "Code Helper" 和 pkill -f Electron
然后用任意文本编辑器打开对应路径下的 locale.json（仅写这一行，UTF-8 无 BOM）：
{"locale":"zh-cn"}
- Windows 路径：
%APPDATA%\Code\User\locale.json - macOS 路径：
$HOME/Library/Application Support/Code/User/locale.json - Linux 路径：
$HOME/.config/Code/User/locale.json - 切记：不能有逗号、空格、BOM、多余换行；不能写成
"zh-cn "或"ZH-CN"
远程开发环境要单独部署
本地装了中文包，对 SSH 或 WSL 远程窗口完全无效。VSCode 的语言配置不跨连接传输，远程窗口启动时只读取远程机器上的 locale.json 和已启用扩展。
操作路径：
– 点击右下角状态栏的 SSH: xxx → 点击 Install 'Chinese (Simplified) Language Pack' in SSH: xxx
– 安装完成后，再在远程窗口中运行 Configure Display Language 并选 zh-cn → 点 Restart
- 若远程无图形界面（如纯终端服务器），需手动在远程机器上创建
locale.json，路径与本地一致 - Linux 远程：
~/.vscode-server/data/Machine/locale.json
Windows 远程：%USERPROFILE%\AppData\Roaming\Code\User\locale.json - 别指望“一次安装，处处生效”——每个目标环境都得独立走完
Install from VSIX+Configure Display Language+Restart三步
