必须安装Microsoft官方中文语言包并执行Configure Display Language命令选择zh-cn后重启窗口，手动修改settings.json时locale值须为小写连字符格式，离线安装需用.vsix文件通过Install from VSIX命令。

安装中文语言包必须认准 Microsoft 官方插件

vscode 的中文界面不是靠“汉化补丁”或第三方翻译实现的，而是通过官方发布的语言包扩展。如果装了非 microsoft 发布的“中文插件”，大概率只改菜单栏文字、不翻设置项，甚至导致命令面板乱码或崩溃。

• 打开扩展面板：Ctrl+Shift+X（Windows/Linux）或 Cmd+Shift+X（macOS）
• 搜索关键词：Chinese (Simplified) Language Pack for Visual Studio Code
• 确认发布者是 Microsoft，不是“Chinese Language Pack”“VSCode Chinese”等模糊名称
• 点击 Install，等待状态变为 Installed

注意：安装完不会自动切换语言，这只是“备好弹药”，还没扣扳机。

切换显示语言必须用 Configure Display Language 命令

很多人装完就关 VSCode 重启，结果发现还是英文——因为 VSCode 默认仍使用系统语言或上一次配置，语言包本身不主动激活。

• 按 Ctrl+Shift+P 打开命令面板
• 输入并选择：Configure Display Language
• 在弹出列表中选 zh-cn（不是 zh-CN 或 Chinese）
• VSCode 会提示“需要重启窗口以应用更改”，点 Restart 或手动关闭再启动

重启后若右下角状态栏显示 en，可点击它手动切回 zh-cn；这是最直接的验证方式。

settings.json 中的 locale 配置项必须小写连字符

当命令面板失效（比如插件冲突、UI 卡死），或者你想批量部署、脚本化配置时，就得手动编辑配置文件。这里最容易出错的是格式和大小写。

• 打开设置 JSON：Ctrl+, → 右上角点击 Open Settings (JSON) 图标
• 添加或修改这一行："locale": "zh-cn"
• 不能写成 "locale": "zh_CN"、"locale": "zhCN" 或 "LOCALE": "zh-cn"
• 保存后执行 Developer: Reload Window（不用全重启，但部分旧版本仍需重启）

如果改完没反应，检查是否多写了逗号、引号不匹配，或被其他插件的配置覆盖（比如某些主题插件会偷偷重写 locale）。

离线环境安装需用 .vsix 文件 + Install from VSIX

公司内网、教育网或防火墙严格限制时，扩展市场打不开，但语言包本身是纯静态资源，完全支持离线部署。

• 在能联网的机器上访问：https://marketplace.visualstudio.com/items?itemName=MS-CEINTL.vscode-language-pack-zh-hans
• 点击 Download Extension，得到一个 vscode-language-pack-zh-hans-*.vsix 文件
• 在目标机器的 VSCode 中按 Ctrl+Shift+P，输入并运行：Extensions: Install from VSIX...
• 选中下载好的 .vsix 文件，安装后仍需执行 Configure Display Language → zh-cn → Restart

别试图把 .vsix 解压后复制进 extensions 目录——VSCode 1.80+ 已弃用这种手动拷贝方式，会导致插件无法启用或报 Extension is not installed 错误。

真正卡住人的往往不是“找不到插件”，而是装完没切语言、切了没重启、重启了 locale 写错格式、或者用了非官方包。只要每步都盯住 Microsoft、zh-cn、Restart 这三个关键词，基本不会翻车。