VSCode 中文界面重启失效的根本原因是 locale 配置未生效或进程未彻底退出;必须通过 Configure Display Language 命令写入正确的 {"locale": "zh-cn"} 到用户级 locale.json,并杀净所有 Code 进程后重启。

VSCode 设置中文界面后重启失效,**根本原因几乎总是 locale 配置没真正生效或进程没清干净**——不是插件装错了,也不是 VSCode 坏了,而是它压根没读到你写的 zh-cn。
Configure Display Language 命令没运行过
装完 Chinese (Simplified) Language Pack for Visual Studio Code 插件,只点 Install 就关掉扩展面板,界面必然还是英文。插件只是“翻译字典”,不自动“翻页”。Configure Display Language 是唯一能正确写入 locale.json 并触发语言加载的入口。
- 必须用
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入完整命令名,不能只输 “language” - 列表里选的是
zh-cn(注意是小写 + 连字符),不是 “简体中文” 文字项,也不是zh-CN或zh-hans - 点 Restart 后,务必等窗口完全关闭再重新打开;若右下角仍显示
en,说明没生效
locale.json 路径或内容格式错
VSCode 只认用户级 locale.json,且只接受严格 JSON 格式。手写、复制粘贴、加注释、改大小写,都会导致静默 fallback 到英文。
- 文件路径必须准确:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 内容只能是这一行:
{"locale": "zh-cn"}(双引号、小写、连字符、无空格、无逗号、无其他字段) - 如果文件存在但内容异常(比如有注释、多字段、用了单引号),直接删掉重写,别修
重启没彻底退出进程
Restart Now 按钮在多数情况下只是软重启,后台 Code.exe 或 Code Helper 进程还在跑,新实例会复用旧环境,locale 状态不会刷新。
- Windows:打开任务管理器 → 结束所有
Code.exe进程(包括 GPU、Utility、Renderer 类型) - macOS:活动监视器 → 搜索
Code→ 强制退出全部相关进程(不只是 Dock 里 Quit) - Linux:终端执行
pkill -f "code.*--ms-enable-electron-run"或killall code - 确认无残留后,再双击图标或命令行
code启动
插件冲突或缓存卡住
v1.89+ 启用 Ozone 渲染后,对语言包版本和加载顺序更敏感。旧缓存、老插件、多语言包共存,都可能让 zh-cn 被跳过。
- 临时禁用所有非必要插件:
Ctrl+Shift+P→Extensions: Disable All Installed Extensions,只留官方MS-CEINTL.vscode-language-pack-zh-hans - 清除缓存目录:
Windows:%APPDATA%\Code\Cache和%APPDATA%\Code\Local Storage
macOS/Linux:~/.config/Code/Cache和~/.config/Code/Local Storage - 检查语言包版本是否 ≥
1.89.2026052801;旧版会被静默忽略,需卸载重装
真正卡住的,从来不是“会不会装插件”,而是 locale.json 写错一个字符、进程漏杀一个、或者插件多启了一个——这些细节不盯死,重装十遍也没用。


















