必须安装微软官方简体中文语言包、执行Configure Display Language选zh-cn并彻底重启，三者缺一不可；仅认Microsoft发布的Chinese (Simplified) Language Pack for Visual Studio Code（ID：ms-ceintl.vscode-language-pack-zh-hans），搜索须用完整名称，安装后务必点Change and Restart。
必须安装 Microsoft 官方中文语言包、执行 Configure Display Language 命令选 zh-cn、并彻底重启 VS Code，三者缺一不可；少一个，界面就卡在英文。
只认 Microsoft 官方插件，别搜“中文”或“汉化”
VS Code 的中文化依赖翻译资源，但只信任一个扩展：Chinese (Simplified) Language Pack for Visual Studio Code，发布者必须是 Microsoft，ID 是 ms-ceintl.vscode-language-pack-zh-hans。
- 按
Ctrl+Shift+X（Windows/Linux）或Cmd+Shift+X（macOS）打开扩展面板 - 搜索完整名称，**不要搜“中文”“汉化”“Chinese Menu”等关键词**——那些大概率是第三方插件，翻译不全、可能覆盖 locale 配置，甚至引发
Cannot read property 'translate' of undefined - 认准蓝勾图标 + “Microsoft”署名，点击 Install
- 安装后右下角若弹出提示，必须点 Change and Restart；没弹提示，说明安装失败（常见于 VS Code 版本
Configure Display Language 命令只接受 zh-cn，其他写法全无效
语言包只是“字典”，真正激活中文的是 Configure Display Language 命令。它会写入 locale.json，但不重启不会生效。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac）呼出命令面板 - 输入
Configure Display Language（注意大小写和空格，输display也能快速筛选） - 从列表中**只选
zh-cn** ——zh_CN、ZH-CN、zh-hans、Chinese、zh全部无效，且不报错，静默维持英文 - 选完后弹出的 Restart 提示，**必须点**；用
Developer: Reload Window是无效的，它不重载语言资源
命令面板失效时，直接改 locale.json 最稳
当命令面板打不开、搜不到该命令、或选了 zh-cn 重启后仍是英文，说明配置没写成功。此时手动编辑 locale.json 是最可靠兜底方案。
- 先彻底退出 VS Code：Windows 查任务管理器杀光所有
Code.exe；macOS 运行pkill -f "Electron.*Code"；Linux 运行pkill -f "code.*--no-sandbox" - 定位并编辑
locale.json：- Windows：
%APPDATA%\Code\User\locale.json - macOS：
$HOME/Library/Application Support/Code/User/locale.json - Linux：
$HOME/.config/Code/User/locale.json
- Windows：
- 用 VS Code 自己打开该文件，内容严格为：
{"locale":"zh-cn"}（小写、连字符、无空格、UTF-8 无 BOM） - 保存后彻底重启 VS Code
真正容易被忽略的是：终端、调试控制台、Git 输出、部分插件 WebView 页面的语言是独立控制的，它们显示英文 ≠ 主界面汉化失败。盯住顶部菜单栏、“文件”“编辑”“视图”文字、左侧活动栏 hover 文字、设置里搜 locale 看值是否为 zh-cn——这三处对了，就是真汉化成功。
