首要原因是装错插件,必须仅安装microsoft官方发布的“chinese (simplified) language pack for visual studio code”(id:ms-ceintl.vscode-language-pack-zh-hans),其他第三方包不提供完整翻译且可能破坏locale.json读取逻辑。

装错插件是中文不生效的首要原因
搜“中文”“汉化”“简体中文”出来的几乎全是第三方包,比如 Chinese Language Pack、VSCode Chinese,它们不提供完整翻译资源,也不更新,有些甚至会破坏 locale.json 读取逻辑,导致命令面板空白或弹窗无法输入中文。
只认一个扩展:Chinese (Simplified) Language Pack for Visual Studio Code,发布者必须是 Microsoft,ID 是 ms-ceintl.vscode-language-pack-zh-hans。安装时务必粘贴全名搜索,别信图标模糊、描述带广告、下载量低的选项。
常见错误现象:
- 右下角没弹
Restart Now提示 → 安装失败或 VS Code 版本低于 1.13(需先升级) - 扩展已安装但命令面板搜不到
Configure Display Language→ 实际未成功加载语言包
Configure Display Language 命令必须执行且选对值
语言包只是“字典”,VS Code 默认仍用英文启动。真正切换语言靠的是这个内置命令,不是设置里点几下就能改的。
操作路径:Ctrl+Shift+P(macOS 为 Cmd+Shift+P)→ 输入 Configure Display Language → 回车 → 在列表中选 zh-cn(注意:全小写、带短横线、不能是 zh_CN、zh-hans 或 Chinese)→ 点“是”后必须点弹窗里的 Restart。
容易踩的坑:
- 点了
Developer: Reload Window就以为完成 → 这个操作不重载语言环境,无效 - 选错后
settings.json被写成"locale": "zh"这类无效值 → 后续再选也无效,需手动清理 - 命令面板搜不到该命令 → 说明语言包根本没装上,或装完没彻底退出进程
locale.json 文件路径和格式必须严格正确
VS Code 1.70+ 已完全弃用 settings.json 中的 locale 字段。唯一有效路径是用户级 locale.json,且只认以下三个位置:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json
文件内容必须严格为合法 JSON,仅含一行:{"locale":"zh-cn"}(双引号、小写、短横线、无空格、无注释、UTF-8 无 BOM)。
关键细节:
- 不要用记事本或 Sublime 编辑 —— 右下角状态栏必须显示
UTF-8,不能是GBK或UTF-8 with BOM - 文件不存在?直接新建,VS Code 会自动识别
- 改完不生效?先关掉所有窗口,再检查任务管理器(Windows)或活动监视器(macOS)里是否还有残留的
Code.exe或Electron进程
部分界面仍是英文属于正常现象
VS Code 本体菜单(File、Edit、Terminal)、命令面板、设置导航栏能完全汉化,但以下情况显示英文不是你配错了:
- 终端输出、调试控制台、Git 提示信息 —— 它们由系统或底层工具链决定,VS Code 不翻译
- 第三方插件的弹窗、侧边栏标题、报错信息(如
Python、Prettier、GitLens)—— 是否汉化取决于插件作者是否提供本地化支持 - 某些插件需单独安装子包(如 Python 扩展需额外启用中文语言子包)或在设置里确认未被覆盖
最容易被忽略的其实是“彻底关进程”——很多人点完 Restart Now 又立刻开新窗口,旧进程还在后台跑,locale.json 根本没加载。关干净再启动,才是最稳的一步。











