必须安装微软官方中文语言包（id：ms-ceintl.vscode-language-pack-zh-hans），配置 locale 为小写短横线格式的 "zh-cn"，并彻底重启 vs code 才能生效。
装错插件是中文不生效的首要原因
VS Code 没有“汉化补丁”概念，所谓“中文界面”依赖的是微软官方语言资源包，不是第三方改菜单文字的插件。搜“中文”“汉化”“简体中文”大概率装到 Chinese Menu 或 VSCode Chinese 这类非官方扩展——它们不更新、不翻译设置项、命令面板仍为英文，甚至可能覆盖提示文案。
必须安装且仅安装这个插件：
Chinese (Simplified) Language Pack for Visual Studio Code- 发布者必须是
Microsoft - 扩展 ID 是
ms-ceintl.vscode-language-pack-zh-hans
在扩展面板（Ctrl+Shift+X）中，**严格粘贴全名**搜索，只点那个带蓝白 VS 标志 + 中文“中”字图标的选项。装完右下角弹窗若提示“Reload Window”，别点它——这个操作不触发语言切换。
Configure Display Language 命令找不到？说明语言包没装成功
这个命令本质是让 VS Code 写入 {"locale":"zh-cn"} 到配置文件。如果按 Ctrl+Shift+P 输入 Configure Display Language 后无响应、列表为空、或执行后仍是英文，基本可断定语言包未加载——不是 VS Code 有问题，而是插件根本没装上或没重启。
验证方式：
- 命令面板输入
Extensions: Show Installed Extensions，确认ms-ceintl.vscode-language-pack-zh-hans在列表中且状态为Enabled - 若不在，重装；若在但禁用，手动启用
- 装完必须彻底退出所有 VS Code 进程：Windows 查任务管理器中是否还有
Code.exe，macOS 用活动监视器查Code Helper
zh-cn 是唯一有效值，其他写法全无效
选错 locale 值是最隐蔽的失败点。VS Code 严格遵循 BCP 47 标准，只接受小写、短横线格式的 zh-cn。以下写法均被忽略，且无任何报错提示：
-
zh_CN（下划线） -
zh-CN（大写 C/N） -
zh-hans（虽合法但 VS Code 不识别） -
Chinese或zh（不完整）
执行 Configure Display Language 后，从弹出列表中**只选 zh-cn**，然后必须点提示框中的 Restart —— 点 Reload Window 或手动关再开，配置不会加载。
手动改 locale.json 是最稳的兜底方式
当命令面板打不开、公司内网屏蔽扩展市场、或反复切换失败时，直接编辑 locale.json 绕过 UI 层，强制生效。关键是路径、编码、格式三者都得对：
- Windows 路径：
%APPDATA%\Code\User\locale.json - macOS 路径：
$HOME/Library/Application Support/Code/User/locale.json - Linux 路径：
$HOME/.config/Code/User/locale.json
用 VS Code 自己打开该文件，内容**只写一行**：{"locale":"zh-cn"}，保存为 UTF-8 无 BOM 编码，不能有多余空格或逗号。改完后必须全新启动 VS Code，不能复用旧窗口。
真正容易被忽略的是：终端、调试控制台、Git 输出、插件 WebView 页面显示英文 ≠ 汉化失败。VS Code 的 locale 配置只影响主 UI 层（菜单栏、命令面板、设置页），不接管运行时子系统。验证时盯住这三处：顶部菜单栏、Ctrl+Shift+P 提示文字、Ctrl+, 设置页左侧导航是否为中文。
