VSCode插件失效后不会自动回退语言,必须手动重置locale.json配置;该文件若存在且locale值非法(如大小写错误、格式错误),中文插件将完全无效,需删除后通过Configure Language重新生成标准{"locale":"zh-cn"}。

插件失效后,VSCode 默认不会自动回退语言,必须手动重置 locale 配置,否则即使重装中文插件也无效。
检查当前语言配置是否被覆盖
VSCode 启动时优先读取 locale.json,而不是插件状态。如果该文件存在且 "locale" 字段被设为 "en" 或其他值,中文插件就完全不起作用。
- 打开命令面板(
Ctrl+Shift+P/Cmd+Shift+P),运行Configure Language - 若提示“已设置为 en”,说明配置已被写死
- 直接查看配置文件:
$HOME/Library/Application Support/Code/User/locale.json(macOS)、%APPDATA%\Code\User\locale.json(Windows)、$HOME/.config/Code/User/locale.json(Linux) - 该文件只应有一行:
{"locale":"zh-cn"},多一个空格或逗号都会导致加载失败
删除残留的 locale.json 再重新设置
很多用户在尝试多次切换语言后,locale.json 会被写入错误值(比如 "zh-CN" 大小写不匹配,或带 BOM 的 UTF-8 编码),VSCode 会静默忽略它,表现为“插件已启用但界面仍是英文”。
- 退出 VSCode
- 删掉
locale.json文件(不要只是清空内容) - 重新打开 VSCode,再执行一次
Configure Language→ 选Chinese (Simplified) - 此时 VSCode 会生成新的
locale.json,内容为{"locale":"zh-cn"}(注意是小写、无空格、标准连字符)
确认中文包插件是否真正启用
语言包插件(Chinese (Simplified) Language Pack for Visual Studio Code)本身不控制界面语言,只提供翻译资源;它必须配合 locale.json 才生效。常见误判点:
- 插件列表里显示“已启用”,不代表它正在被使用——要看
locale.json是否存在且合法 - 禁用再启用插件,不会刷新当前语言,必须重启 VSCode 才能加载新 locale
- 如果用的是 VSCode Insiders 版本,它的语言配置路径独立:对应
Code - Insiders/User/locale.json,别和 Stable 版混淆
最常被忽略的一点:VSCode 启动时若检测到 locale.json 解析失败(如 JSON 格式错误、locale 值不被识别),它不会报错,也不会 fallback 到插件语言,而是直接按系统语言渲染——这时候你看到的英文,根本不是插件的问题,是配置文件卡住了整个链路。


















