离线安装中文语言包必须用命令面板执行extensions: install from vsix并手动运行configure display language选zh-cn后重启，双击或拖拽.vsix无效；安装后需验证顶部菜单栏、命令面板提示、设置导航栏三处全中文才算生效。
离线安装中文语言包必须用 code --install-extension
离线环境下，VSCode 扩展市场不可用，Ctrl+Shift+X 搜索不到任何插件。此时唯一可靠方式是手动下载 vscode-language-pack-zh-hans.vsix 文件（注意 ID 必须是 ms-ceintl.vscode-language-pack-zh-hans），然后通过命令行安装：
- 从微软 GitHub 官方仓库或可信镜像下载对应 VSCode 版本的
.vsix文件（不建议用第三方打包版） - 终端进入该文件所在目录，执行：
code --install-extension vscode-language-pack-zh-hans.vsix - 成功后不会弹窗提示，但可在扩展面板里看到已安装、发布者为 Microsoft 的条目
- 若报错
command 'code' not found，说明 VSCode 未加入系统 PATH；Windows 可改用绝对路径，如："C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code\bin\code" --install-extension xxx.vsix
Configure Display Language 命令在离线环境仍可用
语言包安装成功后，Configure Display Language 命令本身不依赖网络——它只是读取已安装的语言资源并写入配置。只要扩展装对了，这个命令就会出现在命令面板中：
- 按
Ctrl+Shift+P→ 输入Configure Display Language（注意大小写和空格，不能缩写） - 列表中应出现
zh-cn选项；选中后会提示“Restart”，**必须点 Restart，不能只点 Reload Window** - 如果命令搜不到，大概率是语言包没装成功，或 VSCode 版本低于 1.13（需先升级）
- 某些企业策略可能禁用命令面板，此时只能手动编辑
locale.json
手动写 locale.json 是离线最稳兜底方案
当命令面板异常、UI 卡死，或需要批量部署时，直接写配置文件是最可控的方式。VSCode 启动时优先读取该文件，且不校验语言包是否存在：
- 文件路径（三选一）：
Windows：%APPDATA%\Code\User\locale.json
macOS：~/Library/Application Support/Code/User/locale.json
Linux：~/.config/Code/User/locale.json - 内容必须严格为单行 JSON：
{"locale":"zh-cn"}（无注释、无多余空格、双引号不可省略） - 保存后务必彻底退出 VSCode：Windows 检查任务管理器中所有
Code.exe进程，macOS 查 Activity Monitor 中 Electron 进程 - 重启后若仍为英文，检查文件编码是否为 UTF-8（非 UTF-8-BOM 或 GBK）
常见失败点：装对包 ≠ 能切语言
离线场景下最容易被忽略的是「包与配置分离」这个事实。装完 .vsix 只是把翻译资源放进磁盘，真正触发切换的是 locale 配置值和进程重启两个动作：
- 装了包但没运行
Configure Display Language，或手动写错了zh-cn（比如写成zh_CN、zh-hans、Chinese）→ 界面不变 - 写了正确的
locale.json但没杀干净后台进程 → 新窗口仍加载旧 locale 缓存 - 误装了非官方插件（名字含“汉化”“中文支持”等）→ 可能覆盖
locale.json或干扰命令面板，导致Configure Display Language消失 - VSCode 版本太老（
离线操作没有试错成本低的优势，每一步都得确认落点：包装进去了吗？配置写对了吗？进程清干净了吗？缺一不可。
