0

0

VSCode集成终端乱码怎么解决_编码设置与字体配置

紅蓮之龍

紅蓮之龍

发布时间:2026-01-13 17:20:02

|

672人浏览过

|

来源于php中文网

原创

终端中文乱码主因是编码、字体、脚本环境三者不一致:cmd默认GBK需切UTF-8(chcp 65001),字体须显式配置中文字体如'Microsoft YaHei Mono',Python/Node.js脚本需设PYTHONIOENCODING=utf-8,Git Bash需关core.quotePath。

vscode集成终端乱码怎么解决_编码设置与字体配置

终端显示中文是方块或问号,先确认系统默认编码

VSCode 集成终端乱码,80% 情况是终端进程(如 cmd.exepowershell.exebash)本身没用 UTF-8 编码启动,VSCode 只是“照搬”了它的输出。Windows 默认的 cmd 用的是 GBK(代码页 936),而现代项目文件名、日志、脚本常含 UTF-8 字符,直接冲突。

验证方式:在集成终端里运行:

chcp
,若输出 活动代码页: 936,就是根源。

  • Windows 用户优先改用 powershellWindows Terminal,它们默认支持 UTF-8
  • 若必须用 cmd,可在 VSCode 设置中强制启动时切换编码:
    terminal.integrated.profiles.windows
    里为 cmd 添加 /c chcp 65001 >nul && cmd
  • WSL 用户检查 locale 输出,确保 LANGen_US.UTF-8zh_CN.UTF-8,不是 C 或空

VSCode 终端字体不支持中文,导致显示为空格或小方块

即使编码正确,如果终端用的等宽字体(如 ConsolasMonacoFira Code)本身不含中文字形,VSCode 就会 fallback 到系统默认中文字体——但 fallback 行为不稳定,尤其在连字(ligature)开启时容易断掉。

解决办法是显式指定一个「支持中文的等宽字体」,并在字体列表中把中文字体放在英文之后,避免覆盖英文渲染效果:

Elser AI Comics
Elser AI Comics

一个免费且强大的AI漫画生成工具,助力你三步创作自己的一出好戏

下载
  • 打开 VSCode 设置(Ctrl+,),搜索 terminal integrated font family
  • 填入类似:
    'Fira Code', 'Microsoft YaHei Mono', 'SimSun', 'Consolas'
  • 注意单引号包裹、逗号后带空格、中文字体名用全称(Microsoft YaHei MonoYaHei 更可靠)
  • 重启终端(关掉所有终端页签再新开),不要只 reload 窗口

Python/Node.js 脚本输出乱码,和终端设置无关但表现一样

这类问题常被误判为终端配置问题,实际是脚本运行时环境没识别到 UTF-8。比如 Python 在 Windows 上调用 subprocess 执行命令,或 Node.js 的 child_process 启动子进程,底层仍可能走系统默认编码。

  • Python 脚本开头加:
    import io, sys; sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
  • Node.js 启动时加 --icu-data-dir 或设置环境变量:
    set PYTHONIOENCODING=utf-8
    (Windows)或
    export PYTHONIOENCODING=utf-8
    (macOS/Linux)
  • VSCode 的 launch.json 中调试 Python 时,可加 "env": {"PYTHONIOENCODING": "utf-8"}

Git Bash 终端中文路径显示为八进制转义,其实是 Git 自身配置问题

Git Bash(msys2)默认对路径做转义,例如 中文.txt 显示成 \344\270\255\346\226\207.txt,这不是 VSCode 或字体的问题,而是 Git 的 core.quotePath 开启了。

关闭它即可还原正常显示:

  • 在 Git Bash 中运行:
    git config --global core.quotePath false
  • 或者在 VSCode 集成终端中(确保是 Git Bash)执行同命令
  • 该设置只影响路径显示,不影响文件内容读写
终端乱码真正卡点往往不在 VSCode 设置本身,而在下层 shell 进程的编码继承、字体链的 fallback 顺序、以及脚本运行时环境三者是否一致。改完任一环节都建议重启终端实例,而不是仅 reload 窗口。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

749

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

635

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

758

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

618

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1262

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

547

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

577

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

706

2023.08.11

php与html混编教程大全
php与html混编教程大全

本专题整合了php和html混编相关教程,阅读专题下面的文章了解更多详细内容。

1

2026.01.13

热门下载

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

精品课程

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

共48课时 | 7.1万人学习

Git 教程
Git 教程

共21课时 | 2.6万人学习

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

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