vscode终端中文乱码根源是终端未启用utf-8编码支持,windows默认使用gbk;需在powershell配置中添加chcp 65001命令、修改python输出编码、适配git bash/wsl环境并重启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 也可能缓存旧值:
- 临时验证:在终端中先运行
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里 exportLANG
最常被跳过的环节是:改完设置后没关掉所有终端窗口再重启 VSCode。VSCode 会复用已有终端进程,旧的 chcp 状态不会刷新。另外,某些老旧 Python 包(比如早期版本的 colorama)会在初始化时强行重置 stdout 编码,这时候光调终端没用,得看具体包的文档。











