必须安装microsoft官方中文语言包并正确配置locale为zh-cn，否则界面不会变中文；装错插件会导致乱码或渲染异常，且需彻底重启而非仅reload。
安装中文语言包必须认准 Microsoft 官方扩展
VS Code 界面不会因为装了任意“中文插件”就变中文，只认 Chinese (Simplified) Language Pack for Visual Studio Code 这一个扩展，发布者必须是 Microsoft，ID 是 ms-ceintl.vscode-language-pack-zh-hans。装错第三方汉化插件（比如名字带“汉化”“破解”“增强版”的）会导致命令面板乱码、设置项不翻译，甚至部分 UI 渲染异常。
常见错误现象：
- 搜索
chinese出现多个结果，点了评分高但发布者不是Microsoft的插件 - 安装后右下角没弹提示，或点了
Reload但界面仍是英文（Reload不触发语言刷新） - VS Code 版本低于
1.13，根本搜不到该扩展——需先升级
实操建议：
- 按
Ctrl+Shift+X打开扩展面板，输入完整名称Chinese (Simplified) Language Pack for Visual Studio Code，只认蓝勾认证 - 安装完别点右上角的
Reload，必须彻底重启（关闭所有窗口 + 杀后台进程） - Windows 下检查任务管理器是否有残留
Code.exe或Code Helper；macOS 查Electron进程
Configure Display Language 命令必须选 zh-cn
语言包只是资源容器，真正控制界面语言的是 locale 配置项。这个值必须严格写成 zh-cn（小写、连字符），写成 zh_CN、zh-hans、zh 或 Chinese 全无效，VS Code 会静默回退到英文。
实操建议：
- 按
Ctrl+Shift+P输入Configure Display Language，从弹出列表里直接选zh-cn - 不要手动编辑
settings.json——这个命令实际改的是locale.json，写错位置或格式没用 - 如果命令面板没反应，说明扩展没装好，或 VS Code 正在加载中，等几秒再试
locale.json 手动配置是最稳的兜底方案
当命令面板不可用、切换失败或企业策略锁死设置时，直接编辑 locale.json 文件绕过 UI 层，是当前最可靠生效路径。它不依赖扩展状态，也不受缓存干扰。
文件路径：
- Windows：
%APPDATA%\Code\User\locale.json - macOS：
$HOME/Library/Application Support/Code/User/locale.json - Linux：
$HOME/.config/Code/User/locale.json
实操建议：
- 关掉所有 VS Code 窗口，包括后台进程，再新建或编辑该文件
- 内容只写一行：
{"locale":"zh-cn"}，保存为 UTF-8 无 BOM 编码 - 文件不存在？直接新建，VS Code 会自动识别——不用提前创建目录
- 改完立刻重启，不用等任何提示
部分界面仍是英文？先排查这三处
设置生效后，Git 面板、调试控制台、某插件 WebView 页面仍显示英文，大概率不是语言包问题，而是组件自身未适配或配置被覆盖。
实操建议：
- 检查插件是否自带语言设置：比如
gitlens.language、prettier.locale，这些需单独设为zh-cn - Remote-SSH / WSL 场景下，语言包和
locale.json必须在远程环境也执行一遍 - 用了非默认主题（尤其第三方暗黑 UI 主题），可能强制继承英文样式，换回
Default Dark+测试
最常被忽略的是“没关干净”——后台进程还在跑，新窗口复用旧环境，看起来像没生效。验证是否真生效，唯一可靠方式是任务管理器 / 活动监视器里确认进程已清空。
