0

0

为什么VSCode的终端显示乱码_如何解决编码与字体问题【教程】

狼影

狼影

发布时间:2026-01-23 12:04:51

|

360人浏览过

|

来源于php中文网

原创

vscode终端乱码主因是底层终端未启用utf-8:cmd需chcp 65001,powershell需$outputencoding=[system.text.encoding]::utf8,字体须显式配置中文字体如'microsoft yahei mono',且必须关闭所有终端页签后重新打开。

为什么vscode的终端显示乱码_如何解决编码与字体问题【教程】

VSCode 终端显示乱码,**80% 不是 VSCode 的锅,而是终端进程(cmd.exepowershell.exebash)自己没用 UTF-8 启动,VSCode 只是“照搬”了它的乱码输出**。编码设对了、字体配好了,但终端底层仍以 GBK 输出字节,VSCode 再怎么解码也救不回来。

终端乱码先查 chcp[Console]::OutputEncoding

Windows 下终端是否真在用 UTF-8,不能只看 VSCode 设置,得进终端里亲手验证:

  • 在 VSCode 集成终端中运行 chcp —— 若返回不是 65001(UTF-8 代码页),说明 cmd 根本没切换编码
  • 在 PowerShell 中运行 [Console]::OutputEncoding —— 若输出不是 System.Text.UTF8Encoding,说明 PowerShell 自己没设对输出编码
  • chcp 65001 只对当前会话生效;要持久化,必须写进终端启动参数,比如在 settings.json 中配置:
    "terminal.integrated.profiles.windows": { "Command Prompt": { "path": "cmd.exe", "args": ["/k", "chcp", "65001"] } }
  • PowerShell 永久生效更推荐改 $PROFILE:添加一行 $OutputEncoding = [Console]::OutputEncoding = [System.Text.Encoding]::UTF8,否则即使 VSCode 设了 terminal.integrated.defaultEncoding: "utf8",也拦不住 PowerShell 先吐出 GBK 字节

terminal.integrated.fontFamily 必须显式指定中文字体

编码正确但依然显示方块?那是字体没撑住中文——VSCode 默认的 ConsolasFira Code 本身不含中文字形,fallback 行为又不稳定,尤其开了连字(fontLigatures)后容易断掉。

TemPolor
TemPolor

AI音乐生成器,一键创作免版税音乐

下载
  • 不要只填 "Fira Code",要写成:"'Fira Code', 'Microsoft YaHei Mono', 'SimSun', 'Consolas'"(单引号包裹、逗号后空格、中文字体名用全称)
  • Microsoft YaHei MonoMicrosoft YaHei 更可靠,它是等宽变体,避免中英文混排时列对不齐
  • 改完设置后,必须关闭所有终端页签再按 Ctrl+Shift+` 新开一个——reload 窗口或只关终端再点加号都不行,旧进程字体缓存不会刷新
  • macOS/Linux 用户注意:PingFang SCNoto Sans CJK SC 这类字体名必须拼写准确,不能写成“苹方”或“思源黑体”

别被“UTF-8 with BOM”和系统区域设置坑了

两个隐蔽但高频的雷:

  • 文件本身是 UTF-8 with BOM,VSCode 会识别为 UTF-8,但某些 Python 脚本或 Node.js 子进程读取时可能把 BOM 当作非法字符,导致后续解析错位——右下角点编码 → Save with Encoding → 选 UTF-8(不带 BOM)
  • Windows 系统勾选了“Beta 版:使用 Unicode UTF-8 提供全球语言支持”,看似利好,实则会让传统 CMD/PowerShell 的 chcp 行为异常,有时反而触发双重编码转换。建议:若已启用并出现乱码,先取消勾选 + 重启,再单独靠 chcp 65001$OutputEncoding 控制
  • Python 脚本输出中文乱码?别只改 VSCode 设置。加一句 import sys; sys.stdout.reconfigure(encoding="utf-8")(Python 3.7+),或启动时加环境变量 set PYTHONIOENCODING=utf-8

最常被跳过的一步:改完所有设置后,一定要关掉所有终端页签再新开——VSCode 终端进程是独立子进程,它的编码和字体是在启动瞬间确定的,后续改配置根本不影响它。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

454

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

546

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

334

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

82

2025.09.10

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

530

2023.06.20

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

576

2023.07.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

739

2023.08.03

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

6120

2023.08.17

Go高并发任务调度与Goroutine池化实践
Go高并发任务调度与Goroutine池化实践

本专题围绕 Go 语言在高并发任务处理场景中的实践展开,系统讲解 Goroutine 调度模型、Channel 通信机制以及并发控制策略。内容包括任务队列设计、Goroutine 池化管理、资源限制控制以及并发任务的性能优化方法。通过实际案例演示,帮助开发者构建稳定高效的 Go 并发任务处理系统,提高系统在高负载环境下的处理能力与稳定性。

4

2026.03.10

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 10.4万人学习

Git 教程
Git 教程

共21课时 | 4.1万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号