必须认准microsoft发布的ms-ceintl.vscode-language-pack-zh-hans扩展，安装后需执行configure display language并选zh-cn（小写连字符），再重启生效；settings.json中locale字段必须为"zh-cn"，右下角显示zh-cn即验证成功。
安装官方中文语言包必须认准 Microsoft 发布者
VSCode 的中文界面不是靠“汉化补丁”或第三方翻译实现的，而是依赖微软官方发布的 ms-ceintl.vscode-language-pack-zh-hans 扩展。装错插件（比如 Chinese Language Pack 或 VSCode Chinese）会导致设置项乱码、命令面板崩溃，甚至干扰其他插件行为。
操作上只需三步：
- 按
Ctrl+Shift+X（Windows/Linux）或Cmd+Shift+X（macOS）打开扩展面板 - 搜索
Chinese (Simplified) Language Pack for Visual Studio Code - 确认发布者是
Microsoft、图标带蓝白 VS 标志，点击Install
装完不重启 = 白装。右下角弹窗出现后务必点 Restart Now；若没弹窗，手动关闭再启动 VSCode。
切换显示语言必须用 Configure Display Language 命令
语言包只是“字典”，不会自动激活。很多人装完就重启，结果界面仍是英文——因为 VSCode 默认仍沿用系统语言或上一次配置。
正确做法是：
- 按
Ctrl+Shift+P打开命令面板 - 输入并选择
Configure Display Language - 在列表中选
zh-cn（注意：不是zh-CN、Chinese或zh_CN） - 点
Restart或手动重启窗口
重启后右下角状态栏会显示 zh-cn，这是最直接的生效验证方式。
settings.json 中 locale 配置必须小写连字符格式
当命令面板失效（如插件冲突、UI 卡死），或需批量部署时，得手动编辑配置文件。这里最容易出错的是格式和大小写。
打开 settings.json（Ctrl+, → 右上角点击 Open Settings (JSON)），添加或修改：
"locale": "zh-cn"
常见错误包括：
- 写成
"locale": "zh_CN"或"locale": "zhCN" - 漏掉引号、多加逗号导致 JSON 解析失败
- 被主题插件或其他扩展悄悄覆盖了该字段
改完保存后，执行 Developer: Reload Window（比全重启快），但旧版本 VSCode 仍需彻底重启。
插件界面汉化不全是设计限制，不是配置失误
官方语言包仅覆盖约 85% UI，右键菜单、GitLens 按钮、调试器标签、终端标题栏等由 Electron 底层或第三方扩展提供，locale.json 控制不了它们。
补全方案要分情况处理：
- 右键/上下文菜单：装
shengchen.vscode-chinese-menu，装完需重新呼出右键才生效（缓存刷新） - GitLens 等插件：单独在
settings.json里加"gitlens.language": "zh-cn" - 终端和调试控制台：本质是系统级输出，改
LANG=zh_CN.UTF-8（Linux/macOS）或系统区域格式（Windows）才有效
真正难补的是 WebView 类界面——比如 LeetCode 插件的题目页、Jupyter 的 notebook 渲染区，这些必须由插件作者自己实现翻译逻辑，外部无法强制干预。
