VSCode界面显示方框是因为locale.json未生效或沙盒安装限制;必须执行Configure Display Language命令生成正确路径的locale.json,禁用snap/flatpak安装并确保中文字体配置。

VSCode界面全是方框,不是语言包没装,而是locale.json没生效、或被沙盒安装拦住了——多数情况只需重载一次配置,但容易卡在路径错、环境变量覆盖、或用了snap/flatpak安装源。
Configure Display Language 命令必须执行,不能手改 settings.json
VS Code 1.70+ 已彻底弃用 settings.json 中的 "locale" 字段,它只读取用户级 ~/.vscode/locale.json。很多人直接在 settings.json 里加 "locale": "zh-cn",结果毫无反应。
- 按
Ctrl+Shift+P打开命令面板,输入并选择Configure Display Language(注意不是 “Open Settings”) - 选中
zh-cn后保存,VS Code 自动写入~/.vscode/locale.json - 必须完全退出 VS Code:终端执行
killall code,确保托盘进程也清空,再重启
中文语言包要装,但装了不等于自动启用
VS Code 1.80+ 内置多语言框架,但中文语言包仍需手动安装且显式激活——它不随编辑器启动自动加载,也不继承系统语言设置。
- 按
Ctrl+Shift+X进扩展市场,搜Chinese (Simplified) Language Pack for Visual Studio Code - 认准发布者是
Microsoft,点击Install - 安装后若无提示重启,大概率是网络失败或缓存异常:可尝试
code --disable-extensions启动后再重试 - 安装完成但界面仍英文?90% 是上一步
Configure Display Language没执行,而非语言包问题
Snap/Flatpak 安装的 VS Code 几乎必然失效
这类沙盒安装方式默认禁止访问系统语言目录,即使 locale.json 正确、语言包已装,中文界面仍显示为方框——这是权限限制,不是配置错误。
- 终端运行
which code,若路径含/snap/bin/code或/var/lib/flatpak,即属沙盒安装 - 解决办法只有两个:
sudo snap remove code+ 改用官网 .deb 包安装;或用flatpak override --filesystem=host com.visualstudio.code(不推荐,有安全风险) - Ubuntu/Debian 用户优先用
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/packages.microsoft.com.gpg+ 官方 APT 源
界面变中文 ≠ 编辑器内/终端能正常显示中文
菜单和按钮变中文,只说明 UI 层语言加载成功;但注释、文件内容、集成终端里的中文是否清晰,是字体、编码、shell 环境三件事,和语言包无关。
- 编辑器内中文模糊或方块:检查
editor.fontFamily是否含中文字体,例如:"'Fira Code', 'Noto Sans CJK SC', 'sans-serif'" - 右下角状态栏显示
UTF-8但中文仍乱码:点它 →Reopen with Encoding→ 选UTF-8(不是GBK) - 集成终端中文显示为问号:在
settings.json中添加:"terminal.integrated.env.linux": {"LANG": "zh_CN.UTF-8"} - 某些发行版(如 Ubuntu Server 无桌面)缺中文字体:运行
sudo apt install fonts-noto-cjk
真正卡住人的地方,往往不是“怎么设”,而是“设在哪”——locale.json 路径不对、沙盒权限挡路、或者误把终端编码问题当成界面语言问题去调。每个环节都得单独验证,混着调只会互相掩盖真实原因。


















