必须重启VSCode才能生效；仅安装Microsoft官方中文语言包（Chinese (Simplified) Language Pack），禁用状态需手动启用，终端等组件默认不汉化属正常。
插件安装后没反应？先确认是否真装上了
VSCode 插件安装失败或不生效，最常见原因是没装对、没重启、或被禁用。不是所有叫“中文”的插件都管用——只有 Chinese (Simplified) Language Pack for Visual Studio Code（作者 Microsoft）才是官方语言包。
- 打开扩展面板（
Ctrl+Shift+X），搜chinese，只认准带蓝勾、作者是Microsoft的那个，其他第三方汉化插件一律跳过 - 安装完成后右下角会弹
Restart Now提示，必须点它；点Reload Window不行，locale 配置不会加载 - 如果扩展图标变灰，说明被禁用了：点击扩展右上角的齿轮图标 → 选择
Enable Workspace或Enable Global - 装完仍搜不到
Configure Display Language命令？大概率是插件根本没装成功，可去~/.vscode/extensions/目录下检查是否存在MS-CEINTL.vscode-language-pack-zh-hans-开头的文件夹
中文界面没全变？别急着重装，先看这三处
VSCode 的 locale 只控制编辑器本体 UI：菜单栏、设置项、命令面板、侧边栏标签。终端、调试控制台、Git 输出、部分插件弹窗（比如 Python 扩展的 Lint 提示）默认不走 locale，显示英文 ≠ 汉化失败。
- 只验证以下三处是否为中文：
文件、编辑、视图菜单栏；设置搜索框里输入locale后显示的字段值；命令面板（Ctrl+Shift+P）里输入Configure是否能匹配出Configure Display Language - 如果菜单是中文但某些按钮仍是英文，大概率是 VSCode 版本太旧（
不支持语言包），或系统级 locale 冲突（Linux 下 <code>LANG环境变量设成en_US.UTF-8有时会干扰） - macOS 上若重启后仍英文，检查
$HOME/Library/Application Support/Code/User/locale.json是否存在且内容为{"locale":"zh-cn"}，编码必须是 UTF-8 无 BOM
命令面板里搜不到 Configure Display Language 怎么办
这个命令不存在，基本等于语言包压根没装好，或者装了但没重启到生效状态。别试“切换语言”“中文设置”这类模糊词，VSCode 命令名就是固定拼写。
- 先执行
Developer: Toggle Developer Tools，在 Console 里粘贴运行：require('vscode').env.language，返回"en"说明 locale 没生效 - 手动创建或编辑
locale.json文件（路径见各系统文档），内容严格为：{"locale":"zh-cn"}，注意是小写、连字符，不能写成zh_CN或zh-CN - Windows 用户务必在任务管理器里杀掉所有
Code.exe和Code Helper.exe进程，再重新启动；macOS/Linux 用pkill -f "Code"清干净 - 离线环境可直接命令行安装：
code --install-extension MS-CEINTL.vscode-language-pack-zh-hans，前提是已下载vscode-language-pack-zh-hans.vsix
settings.json 里加 locale 字段有用吗
没用。settings.json 里的 "locale": "zh-cn" 是无效配置，VSCode 不读这个字段。locale 必须写在独立的 locale.json 文件里，或通过 Configure Display Language 命令写入该文件。
-
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.json时不要复制粘贴网上带中文引号的代码，容易混入全角字符；推荐用 VSCode 自己新建文件，输入{"locale":"zh-cn"}后保存 - 如果已有
locale.json但内容错误（比如写成"zh"或空值），删掉重写更稳妥，避免 JSON 解析失败
