vscode中文界面必须安装microsoft官方插件ms-ceintl.vscode-language-pack-zh-hans，执行configure display language命令设locale为"zh-cn"，并彻底重启；其他插件均无效且可能干扰配置。
只认 Microsoft 官方插件 ms-ceintl.vscode-language-pack-zh-hans
VSCode 的中文界面支持，只有这一个插件是可靠且持续维护的：ID 为 ms-ceintl.vscode-language-pack-zh-hans，全名 Chinese (Simplified) Language Pack for Visual Studio Code，发布者必须是 Microsoft（不是 “Microsoft Corporation” 或其他变体）。所有带“汉化”“Pro”“Ultimate”“中文插件”字样的第三方包，包括 Chinese Language Pack（作者 13xforever）和 VSCode Chinese，2024 年起已停止更新，VS Code 1.80+ 版本根本不会加载——装了不仅无效，还可能干扰 locale.json 读取。
Configure Display Language 命令是唯一生效入口
装完插件 ≠ 界面变中文。这个命令才是触发语言切换的唯一合法路径，它会自动写入并校验 locale.json。常见错误包括：
- 直接改
settings.json加"locale": "zh-cn"—— VS Code 忽略该字段，不生效 - 点扩展页的 “Reload Window” —— 只重载插件，不重载语言配置
- 手动新建或编辑
locale.json后没彻底退出进程 —— 缓存未清，旧状态残留
正确做法：按 Ctrl+Shift+P → 输入 Configure Display Language → 选 zh-cn → 弹窗点 Restart（不是 Reload）。
locale.json 路径、格式与覆盖优先级必须对得上
locale.json 必须位于用户数据目录下，且内容严格为 {"locale":"zh-cn"}（小写、短横线、双引号包裹）。常见错位点：
- Windows 路径写成
%APPDATA%\Code - Insiders\User\locale.json（错在多写了- Insiders） - macOS 路径拼错成
~/Library/Application Support/Code/User/local.json（local≠locale） - 工作区根目录下存在
.vscode/settings.json，里面写了"locale": "en"—— 它会覆盖用户级设置，导致打开项目时仍英文 - 企业环境设置了
VSCODE_LANG=en环境变量，或组策略锁死 locale —— 手动改文件也无效
部分英文残留是正常现象，别硬补
官方语言包覆盖率约 85%，调试器面板、终端命令提示、部分设置项（如 Remote-SSH 连接日志）、扩展自身的 UI（如 Prettier 输出面板）默认不走 VSCode locale，而是由插件自己控制语言。此时：
- 别装
Chinese Menu或vscode-zh-hans-menu补丁类插件 —— 它们只改右键菜单或个别设置项，无法统一底层资源，还可能和新版冲突 - 终端里显示英文命令（如
git status输出）是系统级行为，和 VSCode 无关，需单独配LANG=zh_CN.UTF-8 - Remote 开发场景下，远程端需单独运行
Configure Display Language，本地设置不继承
最常被跳过的动作：装包 → 忘调命令 → 改错路径 → 没彻底退出进程 → 怀疑插件失效。三步缺一不可，顺序不能颠倒。
