必须安装Microsoft官方中文语言包并手动配置locale.json文件，内容为{"locale":"zh-cn"}且保存为UTF-8无BOM编码，路径依系统而异，安装后需点击Restart Now生效。
装对插件是手动配置的前提
手动改配置前，必须确认已安装 Microsoft 官方的 Chinese (Simplified) Language Pack for Visual Studio Code，扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans。搜“中文”“汉化”大概率装到第三方插件，比如 Chinese Menu 或 vscode-zh-hans-menu，它们只改顶部菜单栏几个字，命令面板、错误提示、调试控制台全是英文，还可能引发 Cannot read property 'translate' of undefined 报错。
正确操作只有三步：
- 按
Ctrl+Shift+X（Windows/Linux）或Cmd+Shift+X（macOS）打开扩展面板 - 搜索框里**完整输入**：
Chinese (Simplified) Language Pack for Visual Studio Code（注意括号、空格、大小写） - 认准发布者为 Microsoft、图标是蓝白 VS 标志的那个，点击
Install
安装完右下角会弹出提示——必须点 Restart Now，仅 Reload Window 不生效。
locale.json 是唯一可靠的手动配置路径
settings.json 里写 "locale": "zh-cn" 在 VS Code 1.70+ 版本中**完全无效**，VS Code 根本不读这个字段。真正起作用的只有用户级 locale.json 文件，且内容必须严格为一行合法 JSON：
{"locale":"zh-cn"}
关键细节：
- 文件必须保存为 UTF-8 无 BOM 编码，带 BOM 会导致整个文件被忽略
- 不能有多余空格、逗号、换行或注释
- 路径因系统而异：
Windows：%APPDATA%\Code\User\locale.json
macOS：$HOME/Library/Application Support/Code/User/locale.json
Linux：$HOME/.config/Code/User/locale.json - 如果文件已存在且含其他字段，直接删光，只留这一行；否则整个文件被跳过
Configure Display Language 命令失效时怎么兜底
命令面板输 Configure Display Language 后列表为空、输不了字、点了 zh-cn 重启后仍是英文——说明 VS Code 没成功写入配置，此时手动编辑 locale.json 是最稳解法。
但要注意：
- 必须**彻底退出 VS Code**：Windows 查任务管理器杀光所有
Code.exe；macOS 在活动监视器结束Code Helper；Linux 用pkill -f "code" - 不要在 VS Code 内部用
Open User Settings (JSON)打开并修改——它打开的是settings.json，不是locale.json - 远程开发（SSH/WSL）下需在远程机器上重复该操作，因为 VS Code Server 读的是远程路径下的
locale.json
为什么改了还是部分英文？这不是配置失败
顶部菜单栏、左侧活动栏 hover 文字、设置页里搜 locale 看值是否为 zh-cn——这三处对了，就是真汉化成功。
终端、调试控制台、Git 输出、Python 插件界面仍显示英文，是正常现象：它们各自维护语言环境，并不随 VS Code 的 locale 变。盯住核心 UI 是否中文即可，别误判为配置失败。
真正容易被忽略的是：VS Code 更新后，locale.json 可能被重置为 {"locale":"en"}，尤其发生在后台自动更新场景下。建议把该文件加入备份清单，或每次更新后快速检查一次。
