VSCode中文显示异常主因是非法JSON导致配置静默失效;需清空settings.json为{}或重命名User目录,并确保locale.json语法正确,彻底退出后重启。

VSCode中文显示异常,八成不是插件没装、也不是系统缺字体,而是配置文件里藏了个非法 JSON —— VSCode 不报错,直接跳过整个 settings.json,导致你改了等于没改。
settings.json 里写了非法 JSON 导致界面/快捷键静默失效
你改完 settings.json,中文菜单还是英文、Ctrl+P 打不开命令面板、字体大小没变、甚至启动卡白屏……这些都不是“插件冲突”或“缓存问题”,大概率是 JSON 格式错了。
- // 注释:JSON 标准不支持行内注释,VSCode 会整份忽略
- 末尾多逗号:
"editor.fontSize": 14,最后那个逗号必须删 - 引号不闭合或用了单引号:
'files.encoding': 'utf8'是错的,必须用双引号 - 类型错误:
"editor.fontSize": "14"字段要数字,不能写成字符串
解决方法:按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入并选择 Preferences: Open Settings (JSON),删掉全部内容,只留 {};保存后**完全退出 VSCode**(macOS 要确认活动监视器里没有 Code Helper 进程),再重启。
locale.json 损坏导致界面语言回退或方块乱码
中文菜单突然变英文、右下角语言标识消失、或者中文显示成“□□□”,往往不是 settings.json 的问题,而是 locale.json 文件损坏了。它不校验格式,一个多余字符就能让语言切换彻底失灵。
- 路径和
settings.json同级:~/Library/Application Support/Code/User/locale.json(macOS)、%APPDATA%\Code\User\locale.json(Windows) - 想强制英文?删掉
locale.json,或把它改成{"locale":"en"} - 别手动编辑它——要用
Ctrl+Shift+P→Configure Display Language来改
INI 或老配置文件中文乱码,别急着“另存为 UTF-8”
双击打开一个旧 INI 文件,中文全变成“鍚嶇О=寮犱笁”,英文路径却正常——这不是文件坏了,是 VSCode 默认用 UTF-8 解码,而文件实际是 GBK 编码。此时点“另存为 UTF-8”会把原本正确的 GBK 字节强行 reinterpret 成 UTF-8,再保存就真毁了。
- 先右下角点击编码显示(如显示
UTF-8),选Reopen with Encoding→GBK - 确认内容正常后,如需转码,用“另存为”并选
UTF-8 with BOM(仅当目标程序明确支持) - 长期维护这类文件?在
settings.json加上:"files.associations": {"*.ini": "ini"}, "files.encoding": "gbk"
重命名 User 目录才是真重置
清空 settings.json 还不行?因为 VSCode 用户配置分散在多个文件里:keybindings.json、storage.json(UI 状态)、snippets/、甚至某些插件的 globalStorage/。残留一项,就可能干扰新设置。
- 确保 VSCode **完全退出**(Windows 查任务管理器,macOS 查活动监视器)
- 找到对应平台的 User 目录:
%APPDATA%\Code\User\(Win)、$HOME/Library/Application Support/Code/User/(macOS)、$HOME/.config/Code/User/(Linux) - 把整个
User文件夹重命名为User.bak,重启 VSCode —— 它会生成全新干净的配置目录 - 如果重命名后恢复,说明旧配置里有顽固问题;可逐个把
.bak里的非 JSON 文件(如snippets)移回来验证
最麻烦的不是哪一步操作难,而是 VSCode 对配置错误的沉默——它不提示、不报错、不警告,只悄悄绕开。所以只要中文显示异常,第一反应不该是重装插件,而是先查 settings.json 和 locale.json 的语法是否合法。











