如何在VSCode终端中解决输出中文字符变成乱码或菱形问号的问题

云杰小哥_7054

云杰小哥_7054

2026-03-25

689人浏览

原创

vscode终端中文乱码根源是终端未启用utf-8编码支持,windows默认使用gbk;需在powershell配置中添加chcp 65001命令、修改python输出编码、适配git bash/wsl环境并重启vscode生效。

如何在vscode终端中解决输出中文字符变成乱码或菱形问号的问题

VSCode 终端中文显示为 或乱码的根源

根本不是字体或编码设置没调对,而是终端本身没启用 UTF-8 编码支持——Windows 默认用的是 GBK(CP936),而 VSCode 内置终端(如 PowerShell、cmd)启动时不会自动继承系统区域设置里的 UTF-8 选项,更不会主动设 chcp 65001。

PowerShell 终端下强制启用 UTF-8 的实操步骤

PowerShell 是 Windows 上最常用也最容易修复的场景,关键在启动前就切换代码页,并确保控制台缓冲区支持 Unicode:

  • 打开 VSCode 设置(Ctrl + ,),搜索 terminal.integrated.defaultProfile.windows,设为 powershell
  • 在用户设置 JSON 中添加:
    "terminal.integrated.profiles.windows": {
      "PowerShell": {
        "source": "PowerShell",
        "args": ["-NoExit", "-Command", "chcp 65001 > $null"]
      }
    }
  • 重启终端,运行 [Console]::OutputEncoding 应返回 System.Text.UTF8Encoding
  • 若仍乱码,检查脚本执行策略:Get-ExecutionPolicy,太严格会跳过 -Command 参数中的指令

Python print 输出中文变 的真实原因和解法

不是 Python 源文件编码问题(# -*- coding: utf-8 -*- 已成历史),而是 Python 进程启动时读取的 sys.stdout.encoding 被终端“骗”成了 cp936,哪怕你手动改了 chcp,Python 也可能缓存旧值:

VSCode
VSCode

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

下载
  • 临时验证:在终端中先运行 chcp 65001,再启动 Python,然后执行 import sys; print(sys.stdout.encoding) —— 必须看到 utf-8
  • 避免每次手动输命令:把 chcp 65001 加进 PowerShell 的 $PROFILE 文件末尾(用 notepad $PROFILE 编辑)
  • 不推荐在 Python 里硬编码 sys.stdout.reconfigure(encoding='utf-8'),它只在 3.7+ 且终端真正支持时才生效,否则报 AttributeError
  • 注意:用 python -u 启动可禁用输出缓冲,但不解决编码问题

Git Bash / WSL 终端中文显示异常的差异点

Git Bash 默认是 UTF-8,但 VSCode 集成终端有时会忽略其 locale 配置;WSL 则完全依赖 Linux 侧设置,和 Windows 区域无关:

  • Git Bash:检查 locale 输出是否含 UTF-8,若为 zh_CN.GBK,在 VSCode 设置中加:
    "terminal.integrated.env.windows": {
      "LANG": "zh_CN.UTF-8",
      "LC_ALL": "zh_CN.UTF-8"
    }
  • WSL:确保 /etc/wsl.conf 有 [boot] systemd=true,并在 WSL 中运行 sudo dpkg-reconfigure locales 勾选 zh_CN.UTF-8
  • 共性陷阱:VSCode 的 terminal.integrated.env.windows 对 WSL 不生效,得在 WSL 的 ~/.bashrc 或 ~/.zshrc 里 export LANG

最常被跳过的环节是:改完设置后没关掉所有终端窗口再重启 VSCode。VSCode 会复用已有终端进程,旧的 chcp 状态不会刷新。另外,某些老旧 Python 包(比如早期版本的 colorama)会在初始化时强行重置 stdout 编码,这时候光调终端没用,得看具体包的文档。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

vscode

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.08.07

2075

5

json是什么
json是什么

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

2023.08.23

3122

1

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

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

2023.10.13

1056

3

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

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

2025.09.10

3539

7

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

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

2023.09.27

2760

5

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

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

2026.02.03

249

24

console接口是干嘛的
console接口是干嘛的

console接口是一种用于在计算机命令行或浏览器开发工具中输出信息的工具,提供了一种简单的方式来记录和查看应用程序的输出结果和调试信息。本专题为大家提供console接口相关的各种文章、以及下载和课程。

2023.08.08

836

5

console.log是什么
console.log是什么

console.log 是 javascript 函数,用于在浏览器控制台中输出信息,便于调试和故障排除。想了解更多console.log的相关内容,可以阅读本专题下面的文章。

2024.05.29

6023

7

自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

2023.07.05

6039

9

热门下载

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

精品课程

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