中文不生效的首要原因是装错插件，真正有效的只有 Microsoft 官方的 Chinese (Simplified) Language Pack（ID：ms-ceintl.vscode-language-pack-zh-hans），安装后必须重启并配置 locale 为严格小写的 zh-cn。
装错插件是中文不生效的首要原因
搜“中文”“汉化”大概率装到第三方包，比如叫 Chinese Menu 或 VSCode Chinese 的插件——它们只改顶部菜单栏几个字，不翻译设置项、命令面板、错误提示，还可能覆盖默认文案、引发乱码。真正起作用的只有一个：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”，容易漏掉空格和大小写
- 认准蓝白 VS 图标 + 蓝勾认证，不是所有带“Chinese”的都是它
- 安装完右下角弹出
Restart Now提示，必须点它；点Reload Window不生效
Configure Display Language 命令只认 zh-cn
装完语言包只是“备好了字典”，真正决定界面语言的是 locale 配置值。这个值必须严格符合 BCP 47 标准：zh-cn（全小写、连字符、无空格），任何变体都会静默失败：
-
zh_CN、ZH-CN、zh-hans、Chinese (Simplified)—— 全无效 - 命令面板里搜
Configure Display Language后，列表中要手动滚动找到zh-cn，不能靠关键词匹配 - 选中后弹窗提示“重启窗口”，必须点“是”；点了“否”或关掉弹窗，配置压根不会写入
如果命令面板没反应、列表为空，或者点了没变化，基本可以判定语言包根本没加载成功，不是命令用错了。
手动改 locale.json 是最稳的兜底方式
当命令面板卡死、切换后仍英文、或企业策略锁死 UI 设置时，直接编辑配置文件绕过所有中间层。关键是路径、编码、格式三者都得对：
- 先彻底退出 VS Code：Windows 查任务管理器杀光所有
Code.exe进程；macOS 在活动监视器里结束Electron和Code Helper；Linux 执行pkill -f "code.*--no-sandbox" - 定位并用 VS Code 自己打开
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：
- 文件内容**仅且只能有一行**：
{"locale":"zh-cn"}，UTF-8 无 BOM，无多余空格、逗号或换行
保存后全新启动 VS Code，不是“重新打开窗口”。右下角状态栏仍显示 en？说明旧进程还在跑。
部分界面仍是英文，这不是 bug
VS Code 的 locale 配置只影响主 UI 层（菜单栏、侧边栏、命令面板、设置页标题等）。以下情况显示英文是正常行为，不是汉化失败：
- 终端（Terminal）里的文字：由 shell 或系统
LANG环境变量控制，和 VS Code 无关 - 调试控制台（Debug Console）：取决于调试器（如 Node.js、Python）自身的本地化支持
- Git 面板、Copilot Chat、某些 WebView 插件页：语言由远程服务返回，本地
locale不起作用 - 第三方插件（如
GitLens、Prettier）的按钮、弹窗、侧边栏标题：需插件自身提供中文语言包，例如GitLens有独立配置项gitlens.language
验证是否真生效，唯一可靠方式是打开命令面板（Ctrl+Shift+P），看提示文字是不是“请输入命令或搜索设置”——其他地方哪怕全是英文，只要这句变了，就说明主体汉化已成功。
