VS Code 中文显示异常的根源是语言包未正确安装或配置冲突,需卸载第三方汉化插件、彻底退出进程后重装官方语言包,并确保 locale.json 内容为 {"locale":"zh-cn"} 且路径正确,同时清除 settings.json 中已弃用的 locale 字段。

Configure Display Language 命令搜不到
这说明 ms-ceintl.vscode-language-pack-zh-hans 根本没装成功,或装完后 VS Code 进程未完全退出。第三方“汉化插件”会污染扩展加载链,导致官方语言包被跳过。
检查步骤如下:
- 打开扩展面板(
Ctrl+Shift+X),搜索chinese,只保留发布者为 Microsoft、ID 严格匹配ms-ceintl.vscode-language-pack-zh-hans的那一项 - 卸载所有名字含“汉化”“一键”“中文支持”的插件(如
Chinese Language Pack、VSCode Chinese) - 彻底退出 VS Code:Windows 查任务管理器杀光所有
Code.exe,macOS 用活动监视器确认无Code Helper进程 - 重装语言包后,必须用
Ctrl+Shift+P输入完整命令名Configure Display Language(不含空格/错字),不能输成Change Language或Set Language
选了 zh-cn 却还是英文界面
常见原因是 settings.json 里残留了冲突配置,或 locale.json 路径/内容不合法。VS Code v1.70+ 已弃用 settings.json 中的 locale 字段,但它仍会优先覆盖其他设置。
快速排查清单:
- 按
Ctrl+,打开设置页 → 右上角点“打开设置 (JSON)” → 搜索"locale"→ 删除整行(包括引号和逗号),保存 - 手动检查
locale.json是否存在于正确路径:
Windows:%APPDATA%\Code\User\locale.json
macOS:~/Library/Application Support/Code/User/locale.json
Linux:~/.config/Code/User/locale.json - 文件内容必须是且仅是:
{"locale":"zh-cn"}(双引号、小写、短横线、无空格、无注释、UTF-8 无 BOM) - 改完后必须完全退出 VS Code 再启动,
Developer: Reload Window不生效
菜单部分中文、部分英文,或右下角状态栏显示 en
状态栏显示 en 是最直接的失效信号——说明 locale.json 未被读取或内容非法。而顶部菜单中文、右键菜单仍是英文,属于正常限制,不是错误。
重点注意以下几点:
- 右键菜单(如
Copy Path、Reveal in Explorer)、终端标签(Terminal 1)、状态栏缩写(Ln 12, Col 5)由 Electron 或操作系统底层提供,无法通过语言包汉化 - 如果状态栏显示
en,先确认locale.json存在且内容为{"locale":"zh-cn"};再检查是否被企业策略组、多版本管理器或同步服务覆盖 - Remote-SSH / WSL 场景下,本地设中文不影响远程窗口——需在远程终端中手动创建
~/.vscode-server/data/Machine/locale.json,内容同样为{"locale":"zh-cn"},然后重启远程窗口 - 某些旧版语言包(v1.89 之前)在 Ozone 渲染下会被静默忽略,建议升级到 ≥1.89.2026052801 版本
window.zoomLevel 导致界面错位
汉化后侧边栏图标变形、资源管理器文字截断、悬浮菜单飘出屏幕,几乎全是 window.zoomLevel 配置不当 + 系统 DPI 缩放叠加所致,和语言包无关。
修正方式很直接:
-
window.zoomLevel必须是数字,不能是字符串:"window.zoomLevel": 1✅,"window.zoomLevel": "1"❌ - 优先使用整数:-1、0、1、2;避免小数(如 0.3、0.5),易引发渲染模糊与布局错乱
- 多显示器场景下,VS Code 不支持按屏切换缩放,拖到副屏错位时可临时按
Ctrl+Shift+P→View: Toggle Full Screen强制重排 - 禁用
Custom CSS and JS Loader等劫持样式的插件,它们会破坏汉化后的宽度计算逻辑
settings.json 里的 locale 字段却不知道它已失效——这些操作留下的残留比问题本身更难定位。


















