讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

Laper
Laper

剧本策划到成片协作

AniShort
AniShort

AI短剧协同制作平台

剧云
剧云

中文短剧剧本制作平台

VSCode中文字符变成方框的原因

风辰同学_6213

风辰同学_6213

发布时间:2026-11-14 08:27:31

|

794人浏览过

|

来源于php中文网

原创

VSCode中文注释/字符串显示方框是editor.unicodeHighlight功能误判所致,非字体问题;关闭editor.unicodeHighlight.nonBasicASCII、invisibleCharacters和ambiguousCharacters三项设置即可解决,无需重启,保存即生效。

vscode中文字符变成方框的原因

中文注释/字符串里出现方框,不是字体问题

VSCode 1.64+ 默认开启 editor.unicodeHighlight 功能,会把所有非 ASCII 字符(包括中文、日文、emoji)当作“可疑 Unicode 字符”加方框高亮——这不是渲染失败,而是主动叠加的 SVG 图形层。鼠标悬停在方框上,通常会显示类似 U+4F60 的码点提示,这就是确认信号。

这类方框只出现在编辑器内容区(注释、字符串字面量),不影响界面菜单、终端或侧边栏;也不报错、不崩溃,容易被误判为字体缺失。

  • 禁用最直接:设 editor.unicodeHighlight.nonBasicASCII 为 false
  • 顺带关掉另外两个开关更彻底:editor.unicodeHighlight.invisibleCharacters 和 editor.unicodeHighlight.ambiguousCharacters
  • 不想全关?可用白名单:editor.unicodeHighlight.allowedLocales 设为 ["zh-hans"](注意必须是数组)

编辑器界面或菜单全是方框,大概率是 locale.json 没生效

VS Code 1.70+ 已弃用 settings.json 中的 locale 字段,只认用户级 ~/.vscode/locale.json。很多人手写 "locale": "zh-cn" 到 settings 里,结果完全没反应。

正确做法是:按 Ctrl+Shift+P → 输入并执行 Configure Display Language → 选 zh-cn → 保存。VS Code 会自动生成合法路径的 locale.json。

VSCode
VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载
  • 改完必须完全退出 VS Code:killall code(Linux/macOS)或任务管理器杀干净进程
  • 若用 snap/flatpak 安装,几乎必然失效——沙盒默认禁止访问系统语言资源,换官网 .deb/.rpm 包安装才可靠
  • 中文语言包要装,但装了 ≠ 自动启用;没执行 Configure Display Language,语言包就是摆设

文件打开就是满屏 □,先试右下角 Reopen with Encoding → GBK

Windows 上记事本保存的中文,默认是 GBK 编码,但 VSCode 默认按 UTF-8 解码,字节流对不上,就变成方块。这不是 bug,是行为一致:VSCode 严格按 BOM 或启发式判断解码,而记事本不写 BOM、也不声明编码。

点右下角当前编码(如 UTF-8)→ Reopen with Encoding → 优先试 GBK。如果文字立刻变正常,说明原始编码就是 GBK;如果更乱,关掉重开再试其他选项。

  • Reopen with Encoding 是只读操作,不改文件内容,安全可逆
  • 别信 files.autoGuessEncoding:对无 BOM 的 GBK 文件基本猜错,常判成 windows1252,建议直接设为 false
  • 确认 GBK 能看后,立刻点右下角 → Save with Encoding → utf8(小写,无 BOM),这才是真修复

终端里 print("中文") 是方块或问号,和文件编码无关

编辑器里文件能正常显示 ≠ 终端能正常输出。这是 stdout 编码(Python 进程)和终端解码(CMD/PowerShell/Terminal)没对齐导致的。例如 Python 按 UTF-8 输出,CMD 却用 CP936(即 GBK)去解,中间没协商,必然乱码。

Windows 下最稳方案:在 settings.json 加这一行:"terminal.integrated.env.windows": {"PYTHONIOENCODING": "utf8"}。注意别碰已弃用的 terminal.integrated.encoding,设了也无效。

  • 临时验证:终端里先运行 chcp 65001,再跑 Python 脚本,如果立刻正常,就坐实是这个原因
  • 终端字体也要单独配:terminal.integrated.fontFamily 必须显式列出中文字体,比如 "Cascadia Code", "Microsoft YaHei", "monospace"
  • 改完记得新开终端面板——旧终端不会刷新字体链或环境变量
复杂点在于:同一处“方框”,可能对应四个完全不同的底层机制(Unicode 高亮、locale 加载、文件解码、终端编码),不能靠一个配置通杀。最容易被忽略的是——你看到的“编码显示”只是 VSCode 的当前假设,不是文件真相;而你改的设置,可能根本没被加载(比如 locale.json 路径错、snap 沙盒拦截、锁图标锁定文件)。

热门AI工具

更多
讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

WorkBuddy

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

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

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

豆包大模型

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

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

相关专题

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

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

1615

2023.06.30

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

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

3532

2023.07.21

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

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

2169

2024.03.14

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

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

1767

2024.03.14

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

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

2647

2024.03.15

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

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

1878

2024.03.15

vscode用途介绍
vscode用途介绍

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

1302

2024.03.15

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

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

1156

2024.03.15

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

20

2026.11.12

热门下载

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

精品课程

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

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