讲师中心 微信公众号
AI工具推荐 视频效率加速

VSCode界面全是方框?解决Linux系统下中文乱码【避坑】

秋枫小哥_1882

秋枫小哥_1882

发布时间:2026-06-14 08:33:27

|

902人浏览过

|

来源于php中文网

原创

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

vscode界面全是方框?解决linux系统下中文乱码【避坑】

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+ 内置多语言框架,但中文语言包仍需手动安装且显式激活——它不随编辑器启动自动加载,也不继承系统语言设置。

Obsidian (Linux)
Obsidian (Linux)

操作 Obsidian 库(纯 Markdown 笔记),并通过 notesmd-cli 实现自动化。

下载
  • 按 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 路径不对、沙盒权限挡路、或者误把终端编码问题当成界面语言问题去调。每个环节都得单独验证,混着调只会互相掩盖真实原因。

热门AI工具

更多
墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

1455

2023.06.30

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3072

2023.07.21

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2029

2024.03.14

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1747

2024.03.14

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2607

2024.03.15

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1838

2024.03.15

vscode用途介绍
vscode用途介绍

Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1262

2024.03.15

vscode和visualstudio的区别
vscode和visualstudio的区别

Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

1136

2024.03.15

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

60

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn