0

0

vscode怎么打开外部终端出现乱码

花韻仙語

花韻仙語

发布时间:2026-03-12 18:04:32

|

758人浏览过

|

来源于php中文网

原创

终端乱码主因是外部终端未启用UTF-8编码、字体不支持中文及程序环境变量缺失;需分别配置终端启动参数(如chcp 65001)、指定中文字体(如Cascadia Code PL)、清除BOM并设置PYTHONIOENCODING。

vscode怎么打开外部终端出现乱码

终端乱码不是 VSCode 的问题,是外部终端自己没用 UTF-8

VSCode 点击「在外部终端中打开」(比如右键文件 → Open in Terminal 或使用 code --new-terminal)后中文变 ??? 或方块,90% 情况下 VSCode 没做错任何事——它只是把外部终端(cmd.exepowershell.exewt.exe 甚至 gnome-terminal)吐出来的字节原样展示。而这些终端默认根本没启用 UTF-8。

  • cmd.exe 默认代码页是 936(GBK),chcp 返回的不是 65001 就说明它还在用 GBK 输出
  • powershell.exe 默认用系统区域编码输出,[Console]::OutputEncoding 不是 UTF8Encoding 就等于提前把中文喂成了乱码字节
  • Windows Terminal(wt.exe)虽默认支持 UTF-8,但若其配置里指定了旧版 cmd profile 且没加 chcp 65001,照样乱

怎么让外部终端真正用 UTF-8 启动

关键不是改 VSCode 设置,而是确保你点开的那个终端进程一启动就处于 UTF-8 环境。这需要分终端类型处理:

  • cmd.exe:必须在启动参数里强制执行 chcp 65001,例如在 Windows Terminal 的 settings.json 中为 cmd profile 加:"commandline": "cmd.exe /k chcp 65001"
  • powershell.exe:最稳方式是改 $PROFILE,加一行:$OutputEncoding = [Console]::OutputEncoding = [System.Text.Encoding]::UTF8;别只靠 VSCode 的 terminal.integrated.defaultEncoding,它管不了 PowerShell 自己的输出流
  • wt.exe(Windows Terminal):检查其 profiles.json 里每个 shell 的 commandline 是否含 chcp 65001 或已设 "utf8": true;macOS/Linux 用户同理,确认 gnome-terminaliTerm2 的默认配置里启用了 UTF-8

字体链没配对,UTF-8 也白搭

编码对了,终端还是显示方块?那是字体不认中文。外部终端(尤其 cmd 和旧版 PowerShell)不走 VSCode 字体设置,它用的是系统级终端字体——比如 Windows 的「控制面板 → 字体」或 Windows Terminal 的 font.face 配置。

Sora
Sora

Sora是OpenAI发布的一种文生视频AI大模型,可以根据文本指令创建现实和富有想象力的场景。

下载
  • Windows 下,cmd.exe 只能选等宽位图字体(如 Lucida Console)或 TrueType 字体(如 ConsolasCascadia Code),但 Consolas 本身不含中文字形,必须手动指定支持中文的等宽字体,例如:Cascadia Code PLMicrosoft YaHei Mono
  • 在 Windows Terminal 的 settings.json 中,为对应 profile 显式设:"font": { "face": "Cascadia Code PL" };别指望只改 VSCode 的 terminal.integrated.fontFamily 能影响外部终端
  • macOS/Linux 用户注意:PingFang SCNoto Sans CJK SC 必须拼写完全准确,少一个空格或大小写错误,终端就 fallback 到无中文的字体

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

即使终端和字体都调好了,某些脚本(尤其是 Python 或 Node.js 子进程)仍可能输出乱码——根源常藏在两个隐蔽位置:

  • 文件本身是 UTF-8 with BOM:VSCode 编辑器能识别,但 python xxx.py 执行时,BOM 可能被当作文本开头字符,导致 print("测试") 实际输出 \ufeff测试,终端渲染异常;右下角点编码 → Save with Encoding → 选 UTF-8(不带 BOM)
  • Windows「Beta 版:使用 Unicode UTF-8 提供全球语言支持」勾选了:这个系统级开关会干扰 cmdpowershell 的传统编码逻辑,导致 VSCode 外部终端行为不稳定;建议取消勾选并重启
  • Python 脚本里没设环境变量:set PYTHONIOENCODING=utf-8(Windows)或 export PYTHONIOENCODING=utf-8(macOS/Linux)可强制 Python 标准流用 UTF-8,避免子进程输出错乱

外部终端乱码的本质是三层脱节:终端进程的编码、终端自身的字体、以及它运行的程序的环境变量。三者缺一不可,而且每层都要独立验证——进终端敲 chcplocale,别只信 VSCode 设置界面里写的字。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

WorkBuddy
WorkBuddy

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

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

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

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

456

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的详细内容,可以访问本专题下面的文章。

335

2023.10.13

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

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

82

2025.09.10

python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

192

2023.09.27

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

19

2026.02.03

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

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

530

2023.06.20

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

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

576

2023.07.28

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
go语言零基础开发内容管理系统
go语言零基础开发内容管理系统

共34课时 | 2.7万人学习

第二十三期_前端开发
第二十三期_前端开发

共98课时 | 8.3万人学习

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

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