必须安装microsoft官方插件chinese (simplified) language pack for visual studio code（id：ms-ceintl.vscode-language-pack-zh-hans），再执行configure display language命令选zh-cn并彻底重启，缺一不可；remote环境需在本地和远程分别安装。
插件管理器里搜不到中文语言包？认准官方 ID 和作者
搜 chinese 容易命中一堆非官方插件，真正起效的只有微软官方那个：Chinese (Simplified) Language Pack for Visual Studio Code，作者必须是 Microsoft，ID 是 ms-ceintl.vscode-language-pack-zh-hans。第三方“汉化补丁”类插件不仅不更新，还可能覆盖设置、干扰 locale 读取。
常见错误现象：搜索后点了安装，右下角没弹提示，界面照旧英文——大概率装错了名字相近但作者不是 Microsoft 的插件。
- Windows/macOS/Linux 统一用
Ctrl+Shift+X（或Cmd+Shift+X）打开插件管理器 - 搜索框输入完整名称，别只打“zh”或“中文”，容易漏掉关键词
- 安装后若无自动提示，别关窗口，立刻执行下一步切换语言
Configure Display Language 命令选错值，界面不会变
插件只是“字典”，Configure Display Language 才是“开关”。这个命令必须选 zh-cn（全小写、连字符），不是 zh_CN、zh-CN，更不是界面上显示的“中文(简体)”文字项——它只接受语言代码。
如果你在命令面板里搜到该命令但列表为空，或点开后没有 zh-cn，说明插件根本没装成功，或者 VS Code 启动时没加载语言资源。
- 快捷键
Ctrl+Shift+P→ 输入Configure Display Language→ 回车 - 弹出的下拉列表里只认
zh-cn这个字符串，选中后必须点Restart（不是重载，是彻底关闭再启动） - 重启后仍英文，立刻检查
locale.json文件是否被写错位置或格式损坏
locale.json 放错路径或格式错误，汉化直接失效
locale.json 是最终兜底方案，但它极其敏感：路径错、文件名错、JSON 格式错、编码错，任一环节出问题都会静默失败。
典型错误：把 {"locale":"zh-cn"} 写进 settings.json，或放在工作区目录（.vscode/）里——这个文件只在用户数据目录下生效。
- Windows 路径：
%APPDATA%\Code\User\locale.json - macOS 路径：
$HOME/Library/Application Support/Code/User/locale.json - Linux 路径：
$HOME/.config/Code/User/locale.json - 文件内容只能是单行纯 JSON：
{"locale":"zh-cn"}，不能有注释、空行、中文引号、BOM 头 - 改完必须完全退出 VS Code（包括后台进程），再重新启动
Remote-SSH / WSL 环境下中文不生效？插件要装两遍
VS Code 的 Remote 扩展（如 Remote-SSH、WSL、Dev Containers）运行的是独立服务端进程，本地装的插件对远程环境无效。菜单、设置页能变中文，但终端、调试控制台、远程文件树等仍为英文，就是这个原因。
这不是 bug，是架构设计：远程会话需要自己的语言包副本。
- 连接到远程环境后，在远程侧的扩展面板里重新搜索并安装
Chinese (Simplified) Language Pack for Visual Studio Code - 再在远程窗口中执行
Configure Display Language→ 选zh-cn→ 重启远程窗口 - 如果远程是 Linux 且无图形界面，可临时加启动参数：
code --locale=zh-cn --remote ssh-remote+xxx
locale.json 文件保存时用了带 BOM 的 UTF-8 编码——这个错误不会报错，但会让整个汉化静默失效。
