离线安装VSCode中文包必须通过命令面板执行“Extensions: Install from VSIX”并设locale为"zh-cn"后彻底重启；双击或拖拽.vsix文件无效，因VSCode 1.70+已禁用该机制，仅复制文件而不注册扩展、不加载资源。
离线安装必须用 Extensions: Install from VSIX 命令
双击或拖拽 .vsix 文件进 VSCode 窗口，99% 无效——VSCode 自 1.70 版起已禁用该机制，只会把文件复制到 ~/.vscode/extensions/（Linux/macOS）或 %USERPROFILE%\.vscode\extensions\（Windows），但不注册扩展 ID、不加载语言资源、无任何提示。
唯一可靠路径是：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
Extensions: Install from VSIX并回车 - 在弹出的文件选择框中定位并选中提前下载好的
vscode-language-pack-zh-hans-*.vsix（发布者必须为MS-CEINTL，ID 必须是ms-ceintl.vscode-language-pack-zh-hans） - 点击
Install
装完.vsix 还得手动执行 Configure Display Language
安装 .vsix 只是“放字典”，不是“开翻译”。界面不会自动变中文，必须显式告诉 VSCode 用哪个 locale。
操作步骤：
- 再次按
Ctrl+Shift+P打开命令面板 - 输入
Configure Display Language并回车 - 从下拉列表中**明确选
zh-cn**（小写、短横线、无空格；zh_CN、zh-hans、Chinese全部不识别） - 点提示里的
Restart（不是Reload Window）
若命令面板搜不到 Configure Display Language，说明语言包根本没注册成功，需重试上一步安装。
locale.json 手动写入是最稳的兜底方式
当 UI 卡死、命令面板不可用、或需批量部署时，直接编辑配置文件最可靠。VSCode 启动时优先读取 locale.json，它比 settings.json 中的 "locale" 字段优先级更高。
操作要点：
- 彻底关闭所有 VSCode 窗口：Windows 杀光所有
Code.exe进程；macOS 杀掉Electron；Linux 执行pkill -f "Code Helper" - 找到对应路径并用纯文本编辑器打开：
– Windows：%APPDATA%\Code\User\locale.json
– macOS：$HOME/Library/Application Support/Code/User/locale.json
– Linux：$HOME/.config/Code/User/locale.json - 写入且**仅写入这一行**：
{"locale":"zh-cn"}（UTF-8 无 BOM 编码，无多余空格、逗号或换行）
远程开发环境要单独部署
本地装了中文包，对 SSH/WSL 远程窗口完全无效。远程机器必须独立完成两步：Install from VSIX + Configure Display Language → Restart。
若远程无图形界面（如 Linux 服务器），可手动创建 locale.json：
- Linux 远程：
~/.vscode-server/data/Machine/locale.json - Windows 远程：
%USERPROFILE%\AppData\Roaming\Code\User\locale.json - 内容仍为：
{"locale":"zh-cn"}
验证是否真生效，只看三处：顶部菜单栏、命令面板提示文字、设置导航栏。别被终端输出、Git 提示或右下角状态栏骗了——它们不走 VSCode 的 locale 配置逻辑。
