vscode界面显示方框或乱码的根源是locale.json未生效,需通过configure display language命令生成正确配置、彻底退出进程、禁用沙盒安装、并安装中文语言包,四者缺一不可。

VSCode界面显示方框或乱码,不是语言包没装,而是locale.json没生效、路径错、被沙盒拦截,或根本没执行正确命令。
Configure Display Language 命令必须执行,不能手改 settings.json
VS Code 1.70+ 已废弃 settings.json 中的 "locale" 字段。你手动加 "locale": "zh-cn" 完全无效——它只读取用户级 ~/.vscode/locale.json(Linux/macOS)或 %USERPROFILE%\.vscode\locale.json(Windows),且该文件必须由 VS Code 自己生成。
- 按
Ctrl+Shift+P打开命令面板,输入并选择Configure Display Language(注意:不是 “Open Settings” 或 “Preferences”) - 选中
zh-cn后保存,VS Code 会自动写入正确的locale.json路径和格式 - 如果已手改过
settings.json,请删掉那行"locale",避免干扰
必须完全退出 VS Code,否则 locale.json 不加载
VS Code 的语言配置在启动时一次性读取,运行中修改 locale.json 或执行命令后不重启,界面不会刷新。
详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
- 终端执行
killall code(Linux/macOS)或taskkill /f /im code.exe(Windows),确保所有进程(包括托盘图标)都被杀掉 - 不要只点关闭窗口——最小化到托盘的进程仍在后台运行,会继续读旧配置
- 重启后若仍英文,说明
Configure Display Language没真正执行成功,重试一次
Snap/Flatpak 安装的 VS Code 几乎必然失效
这类沙盒安装方式默认禁止访问系统语言资源目录,即使 locale.json 正确、中文语言包已装,界面仍显示为方框——这是权限限制,不是配置错误。
- 终端运行
which code,若路径含/snap/bin/code或/var/lib/flatpak,即属沙盒安装 - 唯一可靠解法:
sudo snap remove code,然后从官网下载.deb(Debian/Ubuntu)或.rpm(Fedora/RHEL)包安装 -
flatpak override --filesystem=host com.visualstudio.code理论可行但有安全风险,不推荐用于日常开发环境
中文语言包要装,但装了不等于启用
VS Code 1.80+ 内置多语言框架,但中文语言包仍需手动安装并显式激活;它不随编辑器启动自动加载,也不继承系统语言设置。
- 按
Ctrl+Shift+X进扩展市场,搜Chinese (Simplified) Language Pack for Visual Studio Code,认准发布者是Microsoft - 安装后若无提示重启,大概率是网络失败或缓存异常:可尝试
code --disable-extensions启动后再重装 - 安装完成但界面仍英文?90% 是上一步
Configure Display Language没执行,而非语言包问题
最常被忽略的一点:locale.json 生效依赖于 VS Code 进程完全重启 + 非沙盒安装 + 语言包已装 + 命令已执行——四个条件缺一不可,少一个就卡在方框界面不动。别跳步骤,也别靠“试试看”。










