必须完全退出vs code进程并重启,因界面语言仅在启动时读取用户级locale.json文件,内容须严格为{"locale":"zh-cn"};settings.json中配置无效,且仅microsoft官方插件(id ms-ceintl.vscode-language-pack-zh-hans)可用。

为什么装了中文插件还是英文界面
不是插件没装好,而是 VS Code 启动时根本没读到语言配置。它只在启动瞬间加载 locale.json,运行中改文件、点重载窗口(Reload Window)都不生效。
常见错误现象:右下角弹出“Language changed to Chinese (Simplified)”,但菜单栏、设置页仍是英文;或者安装完没提示,手动执行 Configure Display Language 选了 zh-cn,仍无变化。
- 必须完全退出所有 VS Code 窗口(Windows 用任务管理器杀掉
Code.exe,macOS 在活动监视器里结束Visual Studio Code进程) - 重启后仍英文?检查
locale.json内容是否为{"locale":"zh-cn"}——zh_CN、zh-CN、zh全部无效 - Snap 安装的 Linux 版 VS Code 会忽略用户配置,得用
code --locale=zh-cn启动
怎么确认当前生效的语言配置
VS Code 没有“语言设置”图形入口,一切以 locale.json 为准。打开命令面板(Ctrl+Shift+P 或 Cmd+Shift+P),输入并执行 Configure Display Language,它会直接打开该文件。
路径取决于系统:
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
~/Library/Application Support/Code/User/locale.json - Linux:
~/.vscode/User/locale.json
如果文件为空或不存在,说明从未设置过语言;如果内容是 {"locale":"en-us"},哪怕装了中文包也没用。
搜索“中文插件”大概率装错
扩展市场里搜 Chinese 会出现几十个名字带“中文”“汉化”“Language Pack”的插件,但只有 Microsoft 官方那个才真正起作用,ID 是 ms-ceintl.vscode-language-pack-zh-hans。
容易踩的坑:
- 点进
Chinese Language Pack(发布者不是 Microsoft)→ 白装,重启后无反应 - 装了
VSCode Chinese或Chinese Simplified→ 多数是旧版、已弃更,甚至含广告或权限滥用 - 认图标:必须是蓝白 VS 标志 + “Microsoft” 发布者,其他一律跳过
多语言包共存时怎么切换
装多个语言包(比如日文、韩文、简体中文)没问题,最终显示哪种语言,只取决于 locale.json 里的 locale 值,和安装顺序、启用状态无关。
切换方式只有两种:
- 用
Configure Display Language命令从列表选(推荐,不易输错) - 手动编辑
locale.json,把值改成"zh-cn"(简体中文)、"ja-jp"(日语)、"ko-kr"(韩语)等标准 BCP 47 标识
注意:settings.json 里加 "locale": "zh-cn" 是无效的,VS Code 不读这个字段 —— 它只认独立的 locale.json 文件。
最常被忽略的其实是 locale.json 的存在本身。重装系统、换电脑、用 GitHub Settings Sync 同步配置时,这个文件不会自动带过去,插件装了,配置丢了,界面就静默回退到英文,连错误提示都没有。











