必须用 Microsoft 官方语言包（ID：MS-CEINTL.vscode-language-pack-zh-hans）+ Configure Display Language 命令 + 重启三步联动；跳过任一环节或使用第三方汉化插件均会导致失败，常见问题包括命令面板不可见、状态栏无zh-cn选项、菜单中英文混杂等。
必须用 Microsoft 官方语言包 + Configure Display Language 命令 + 重启三步联动，缺一不可；任何跳过命令面板、直接改设置、或装第三方“汉化插件”的做法，大概率失败。
认准唯一有效的语言包 ID
在扩展面板（Ctrl+Shift+X）中搜索 chinese，只安装发布者为 Microsoft、ID 是 MS-CEINTL.vscode-language-pack-zh-hans 的那一项。其他所有名字含“汉化”“中文支持”“一键汉化”的插件，全部无效，且可能污染运行时导致菜单部分乱码或命令面板消失。
常见错误现象：
- 命令面板搜不到
Configure Display Language—— 基本就是装错了插件，或根本没装成功 - 右下角状态栏仍显示
en，点开也无zh-cn选项 —— 插件未被识别，需卸载重装 - 菜单部分中文、部分英文，或弹窗文字错位 —— 第三方插件注入异常脚本，已污染运行时，建议彻底卸载并清空
%USERPROFILE%\.vscode\extensions目录下非 Microsoft 的语言类扩展
切换语言必须走命令面板，不能只改 settings.json
Configure Display Language 是唯一生效开关，语言包只是“备好了字典”，VS Code 默认仍以英文启动。不执行该命令，哪怕 settings.json 里写了 "locale": "zh-cn"，也不会加载中文资源。
操作路径：
-
Ctrl+Shift+P（Mac 用Cmd+Shift+P）打开命令面板 - 输入
Configure Display Language（注意：不含“中文”“change”“language pack”等词） - 回车后选择
zh-cn（必须小写、带连字符，不是zh_CN、zh或Chinese） - 弹出提示后点
Restart—— 不是Reload Window，后者不重新加载语言配置
选错后 settings.json 可能被写成 "locale": "zh" 这类无效值，后续再选也无效，得手动删掉该行再重试。
Remote-SSH / WSL 下中文不生效？那是远程端没配
本地设成中文，不影响远程开发环境的语言显示。Remote-SSH 或 WSL 实例启动的是独立的 VS Code Server 进程，它有自己的 locale.json 配置文件，路径为：
- Remote-SSH：
~/.vscode-server/data/Machine/locale.json - WSL：
~/.vscode-server/data/Machine/locale.json
必须在远程终端中手动创建该文件，内容仅一行：{"locale":"zh-cn"}，保存后重启远程窗口（不是 reload）。注意文件编码必须是 UTF-8 无 BOM，否则整行被忽略。
改完还是英文？检查这三点
如果上述步骤都做了但仍是英文，直接检查以下硬性条件：
- 打开的是用户级
settings.json（用Ctrl+Shift+P→Open User Settings (JSON)），别去改工作区或默认设置 - 文件编码必须是 UTF-8 无 BOM（VS Code 右下角状态栏可查看和切换）
- 只加一行：
"locale": "zh-cn"；已有该字段就只改值，不要重复写 key
macOS 路径：$HOME/Library/Application Support/Code/User/settings.json
Linux 路径：$HOME/.config/Code/User/settings.json
Windows 路径：%APPDATA%\Code\User\settings.json
最常被忽略的是：Remote 环境的 locale.json 文件必须由远程系统生成，本地改了没用；以及 UTF-8 BOM 编码会导致整行配置静默失效——这个坑没有报错，只有排查时才会发现。
