vscode安装中文语言包后仍显示英文,主要因locale配置未正确生效或被覆盖;需通过命令面板执行configure display language并选择zh-cn,保存后彻底重启vscode(非重载窗口),同时检查启动参数、插件及locale.json文件内容是否为{"locale":"zh-cn"}。

VSCode安装中文语言包后仍显示英文
装了Chinese (Simplified) Language Pack但界面没变,大概率是 VSCode 没读到配置,或者配置被更高优先级的设置覆盖。VSCode 语言切换依赖 locale 配置项,且该配置在多个层级存在(用户设置、工作区设置、命令行参数),容易互相干扰。
- 打开命令面板(
Ctrl+Shift+P或Cmd+Shift+P),输入并执行Configure Display Language—— 这是最安全的入口,它会直接编辑locale.json - 确认弹出的下拉菜单里选中了
zh-cn,不是zh或zh-hans(部分旧版语言包只认zh-cn) - 保存后必须重启 VSCode,仅重载窗口无效;如果用了 Remote-SSH / WSL,要关掉远程连接再重启本地主进程
启动时加 --locale=zh-cn 临时生效但不持久
有人试过命令行启动加 --locale=zh-cn 能立刻变中文,但一关再开就回英文——说明配置没落盘。VSCode 启动参数优先级高于配置文件,属于“一次性的覆盖”,不能替代真实配置。
-
--locale参数只影响当前这次启动,不会写入任何配置文件 - Windows 用户若用快捷方式启动,检查目标路径末尾是否误加了
--locale=en(某些推广版或企业镜像会偷偷注入) - macOS/Linux 下如果通过终端 alias 启动(如
alias code='code --locale=zh-cn'),记得每次新开终端要重载 shell 配置,否则 alias 不生效
locale.json 文件位置和手动编辑风险
VSCode 的语言配置实际存放在 locale.json 文件里,路径因系统而异,但内容极简。手改可以绕过 UI 异常,但错一个字符就会让 VSCode 忽略整个文件,退回到英文。
- Windows:
%APPDATA%\Code\User\locale.json - macOS:
$HOME/Library/Application Support/Code/User/locale.json - Linux:
$HOME/.config/Code/User/locale.json - 文件内容只能是严格 JSON 格式,且只允许一个键:
{"locale":"zh-cn"}—— 多余逗号、注释、空格、引号用中文标点都会导致失效 - 如果文件不存在,手动创建即可;如果存在但内容异常(比如值是
"zh"或"chs"),VSCode 会静默忽略并 fallback 到英文
插件或主题强制覆盖界面语言
极少数插件(尤其是旧版国际化工具类插件)会在激活时调用 API 修改 vscode.env.language,或通过修改 DOM 强行替换文字,造成局部中文、全局英文的混乱现象。
- 禁用所有插件后重启,看是否恢复纯中文;若恢复,逐个启用排查
- 特别留意名称含
i18n、l10n、translate、language的插件 - 使用官方主题(如
Default Dark+)测试,排除第三方主题内嵌英文资源的可能
zh-cn 这个值没被正确写进 locale.json,或者被某个看不见的启动参数/插件中途劫持了。改完记得关干净所有 VSCode 进程再开,连托盘图标都右键退出一遍。











