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)开启时容易断掉。

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

Napkin AI
Napkin AI

Napkin 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 窗口。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

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

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

457

2023.08.07

json是什么
json是什么

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

549

2023.08.23

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

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

337

2023.10.13

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

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

82

2025.09.10

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

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

531

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字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

761

2023.08.03

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

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

6259

2023.08.17

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

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

精品课程

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

共48课时 | 10.7万人学习

Git 教程
Git 教程

共21课时 | 4.2万人学习

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

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