必须安装microsoft官方简体中文语言包并执行configure display language命令设为zh-cn，再重启窗口，否则出现半汉化；手动修改locale.json为{"locale":"zh-cn"}可绕过命令失效问题。
装对插件、选对命令、关干净再开——三者缺一不可，否则必然出现菜单中文但设置页英文、命令面板乱码、右下角语言代码不显示 zh-cn 等“半汉化”现象。
必须安装 Microsoft 官方 Chinese (Simplified) Language Pack
第三方插件（如 “Chinese Menu”“VSCode Chinese Pro”）只改几个按钮文字，命令面板、错误提示、设置项全是英文，还可能触发 Cannot read property 'translate' of undefined 报错。真正起作用的只有一个：
- 扩展名称必须是
Chinese (Simplified) Language Pack for Visual Studio Code - 发布者必须是
Microsoft，ID 必须是ms-ceintl.vscode-language-pack-zh-hans - 按
Ctrl+Shift+X打开扩展面板，粘贴完整名称搜索，认准蓝勾图标 - 安装后右下角弹出提示时，**必须点 “Change and Restart”**；只点 “Reload Window” 不生效
Configure Display Language 命令只认 zh-cn，大小写和连字符都不能错
插件只是放好了翻译资源，真正激活中文靠的是这条命令。它不接受任何变体，输 zh_CN、ZH-CN、Chinese 或 zh-hans 全无效，且不报错，静默维持英文。
- 按
Ctrl+Shift+P打开命令面板（不是Ctrl+P），输入Configure Display Language - 从下拉列表中**明确点击值为
zh-cn的那一项**（不是“简体中文”文字项） - 弹窗提示“是否重启窗口”时，必须点
Restart——Reload Window不重读语言配置 - 该命令本质是写入
locale.json，不是settings.json；往settings.json加"locale": "zh-cn"完全无效
命令失效时直接编辑 locale.json 最稳，但路径和格式必须精确
命令面板卡死、搜不到选项、或选了 zh-cn 重启后仍是英文，大概率是 VS Code 没成功写入配置。此时手动改文件比反复重装快得多，但 90% 的失败源于改错位置或没杀干净进程。
- 彻底退出 VS Code：Windows 查任务管理器杀光所有
Code.exe；macOS 在活动监视器结束Code Helper和Electron - 打开对应路径的
locale.json：
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、无多余空格、无逗号、无注释）
验证是否真生效，别被 Git 面板或插件界面误导
终端、调试控制台、Git 输出、部分插件 WebView 页面默认不随 locale 变——那是它们各自的语言环境，不是 VS Code 汉化失败。盯住这三处：
- 顶部菜单栏（文件 / 编辑 / 视图）
- 命令面板提示文字（“请输入命令或搜索设置”）
- 设置界面左侧导航栏（用户 / 工作区 / 扩展）
这三处是中文，locale.json 里确实是 {"locale":"zh-cn"}，且右下角状态栏显示 zh-cn，才算真汉化成功。其他地方还是英文？先查插件自身语言配置，比如 gitlens.language，别急着重装语言包。
