必须安装官方“chinese (simplified) language pack for visual studio code”（id：ms-ceintl.vscode-language-pack-zh-hans），运行configure display language选zh-cn后点restart，或手动编辑locale.json写{"locale":"zh-cn"}并重启。
装错插件是中文不生效的最常见原因
搜“中文”“汉化”“简体中文”会出来一堆非官方包，比如 Chinese Language Pack、VSCode Chinese，它们不是 Microsoft 维护，2026 年起基本失效，还可能引发 Cannot read property 'translate' of undefined 或命令面板空白。必须严格输入全名：Chinese (Simplified) Language Pack for Visual Studio Code，发布者必须是 Microsoft，扩展 ID 是 ms-ceintl.vscode-language-pack-zh-hans。
- Windows/Linux 按
Ctrl+Shift+X，macOS 按Cmd+Shift+X打开扩展面板 - 搜索框里**粘贴全名**，一个空格、括号都不能少
- 只点那个带蓝白 VS Code logo + 中文“中”字图标的选项
- 安装后右下角弹出
Restart Now提示——必须点它，不是“关闭再打开”
Configure Display Language 命令只写配置，不刷新界面
语言包只是把翻译资源放进了本地，Configure Display Language 命令才是真正激活开关。但它只改 locale.json，不会自动重载 UI。很多人点了命令、选了 zh-cn，却没点提示里的 Restart，或误点了 Developer: Reload Window —— 后者只会重载插件，不加载新语言资源。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入并选择
Configure Display Language（注意大小写和空格） - 从列表中选
zh-cn（不是zh-CN、zh_CN、zh、ZH-CN） - 弹窗出现后，必须点
Restart按钮，不能只关窗口再开
手动编辑 locale.json 是最稳的兜底方式
如果命令面板打不开、卡死，或切换后仍无效，说明 VS Code 没读到语言配置。此时直接编辑 locale.json 是唯一可靠路径——它绕过 UI 层，强制指定语言，且 2026 年起该文件是**唯一有效入口**（settings.json 里写 "locale" 已被移除）。
- 先彻底退出 VS Code：Windows 查任务管理器杀掉所有
Code.exe；macOS 在活动监视器里结束Code Helper - 打开对应路径的
locale.json文件：
Windows：%APPDATA%\Code\User\locale.json
macOS：$HOME/Library/Application Support/Code/User/locale.json
Linux：$HOME/.config/Code/User/locale.json - 文件内容只写一行：
{"locale":"zh-cn"} - 用 VS Code 自己打开并保存，确认右下角状态栏显示
UTF-8（不是GBK或UTF-8 with BOM）
验证是否真生效，别被假象骗了
重启后只看三个地方：顶部菜单栏（文件/编辑/视图）、命令面板提示（请输入命令或搜索设置）、设置界面左侧导航（用户/工作区/扩展）。这三处是中文，才算成功。
-
终端、调试控制台、Git 输出显示英文是正常现象——那是 shell 或调试器自己的语言环境，和 VS Code 主界面无关 - Remote-SSH / WSL 下仍是英文？那是远程实例没配，得去远程机器的
~/.vscode-server/data/Machine/xxx/locale.json单独写一遍 - 右下角状态栏如果还显示
en，直接点击它，从下拉菜单选zh-cn是最快兜底方式
Configure Language、选了 zh 而非 zh-cn、点了重载窗口没点重启——只要这四件事做对，1 分钟内就能看到中文菜单。
