Windows控制台运行Python脚本中文显示乱码怎么办

在 Windows 的命令提示符（CMD）或 PowerShell 中运行 Python 脚本时，如果终端输出了类似“锟斤拷”、“烫烫烫”或一连串生僻字、问号与十六进制转义符，其核心原因通常是Python 解释器的文本输出编码与 Windows 控制台活动代码页的解析格式不匹配。在多数情况下，最稳妥、立竿见影的解决方法是在运行前为 Python 开启 UTF-8 运行模式（例如执行 set PYTHONUTF8=1），或者在脚本首部通过 sys.stdout.reconfigure(encoding='utf-8') 主动同步流编码，必要时配合 chcp 65001 命令将控制台窗口切换至 UTF-8。本文将按产生机理、排查步骤、具体修复方案以及差异对比展开，帮助你在不同开发场景下彻底根治中文乱码。

一、Windows 控制台中文乱码的底层成因

要准确解决乱码，首先需要理解字符从 Python 脚本传递到 Windows 控制台屏幕的完整流转链路。在 Python 3 中，内存中的字符串统一采用 Unicode 表示。当程序调用 print() 输出一段中文时，Python 必须将这些 Unicode 字符编码为具体的字节序列，再发送给标准输出设备；随后，Windows 控制台接收这串字节，按照自身当前配置的“活动代码页（Code Page）”进行解码，最后调用终端字体将字形绘制在屏幕上。

导致乱码的关键脱节通常发生在以下两个节点：

• Windows 控制台默认代码页为 CP936（GBK 编码）：中文版 Windows 控制台默认采用代码页 936。GBK 编码下一个汉字占用 2 个字节。
• Python 3 标准流在不同环境下的协商差异：Python 3 的 sys.stdout.encoding 在未额外配置时，通常会参考 Windows 本地区域设置判定为 cp936。若脚本内部包含 UTF-8 独有字符（如特殊符号、Emoji），Python 会直接抛出 UnicodeEncodeError 异常；而如果 Python 被某些编辑器、IDE 或外部重定向机制强制输出 UTF-8 字节（每个汉字占 3 个字节），Windows 控制台却依然按照 GBK 的 2 字节规则强行拼装解码，字符边界发生偏移，就会在屏幕上呈现出杂乱无章的乱码汉字。

二、标准排查路径：五步确认具体环节

遇到乱码时，盲目修改系统全局语言或胡乱添加转码语句往往会引发新的问题。建议按以下步骤依次检查：

1. 查询当前控制台代码页：在命令提示符或 PowerShell 中执行 chcp。如果返回 活动代码页: 936，说明当前窗口处于 GBK 模式；如果返回 活动代码页: 65001，则代表处于 UTF-8 模式。
2. 检验 Python 实际输出流编码：执行以下单行命令：

   python -c "import sys; print(sys.stdout.encoding)"

   观察打印出的是 utf-8 还是 cp936。此时便能清晰对比第 1 步与第 2 步是否匹配。
3. 核对脚本源文件存储格式：确保 .py 脚本是以“UTF-8 无 BOM”格式保存的。如果源码自身被误存为 ANSI/GBK，而解释器按 UTF-8 读取，源码中的中文常数值本身在内存中就已经损坏。
4. 区分是屏幕打印还是外部文件读写：确认报错或乱码是产生自 print() 语句，还是在调用 open() 读取本地文本时抛出的 UnicodeDecodeError。
5. 检查终端显示字体：在老式 CMD 窗口中，若字体被设定为“点阵字体”（Raster Fonts），即便编码完全正确，控制台也因缺乏中文字形库而显示为方块或问号。应切换为 Consolas、新宋体或现代的 Cascadia Code。

三、具体实用的四种修复方法

方法一：设置环境变量启用 Python 的 UTF-8 模式（推荐，零侵入）

自 Python 3.7 起，官方引入了 PEP 540（UTF-8 Mode）。当该模式激活后，Python 会强制将标准输入输出（sys.stdin、sys.stdout、sys.stderr）以及默认文本编码全部指定为 UTF-8，彻底忽略 Windows 底层的区域限制。

1. 在当前控制台临时生效：

# CMD 环境：
set PYTHONUTF8=1
python your_script.py

# PowerShell 环境：
$env:PYTHONUTF8 = "1"
python your_script.py

2. 永久生效（用户环境变量）：

在 Windows 搜索框输入“环境变量”，打开“编辑系统环境变量”，在用户变量中点击“新建”，变量名填写 PYTHONUTF8，变量值填写 1。保存后重新打开终端，此后该用户下所有 Python 进程均默认采用 UTF-8 模式。

方法二：在 Python 脚本内部主动重配置输出流（脚本自带适配）

如果你编写的脚本需要分发给多位同事或用户在不同的 Windows 设备上运行，不能强求所有人预先配置好环境变量，可以在脚本的最顶部主动将标准流编码重设为 UTF-8。该特性支持 Python 3.7+：

import sys

# 检查当前流编码，非 utf-8 时主动重配置
if sys.stdout.encoding.lower() != 'utf-8':
    sys.stdout.reconfigure(encoding='utf-8')
if sys.stderr.encoding.lower() != 'utf-8':
    sys.stderr.reconfigure(encoding='utf-8')

print("你好，世界！控制台中文已正常显示。")

这种做法仅影响该脚本自身的进程生命周期，不产生任何外部依赖，是独立 CLI 工具的最佳实践之一。

方法三：切换 Windows 控制台窗口的代码页为 UTF-8（chcp 65001）

如果在执行其他多语言命令行工具时也伴随乱码，可以直接将当前终端窗口的活动代码页切换为 UTF-8：

# 在 CMD 或 PowerShell 中输入以下命令并回车：
chcp 65001

# 随后再运行 Python 脚本：
python your_script.py

执行 chcp 65001 后，控制台会返回 Active code page: 65001。此时终端已进入 UTF-8 解码状态。需要注意，这一设置默认仅在当前打开的这一个窗口中生效，窗口关闭后自动还原。

方法四：显式规避文件读写中的系统默认编码陷阱

在 Windows 环境下，许多开发者误以为控制台乱码是 print() 的问题，但追溯代码后发现，实际上是 open() 语句读取本地文件时就已经读成了乱码。在 Windows 上，如果不指定 encoding 参数，open() 函数会回退到系统首选区域编码（即 CP936）。

# 错误示范（在 Windows 下极易因默认按 CP936 打开 UTF-8 文件而抛出异常或读取乱码）：
with open("data.txt", "r") as f:
    text = f.read()

# 正确规范（始终显式声明 encoding='utf-8'）：
with open("data.txt", "r", encoding="utf-8") as f:
    text = f.read()
print(text)

四、核心方案对比：PYTHONUTF8 与 chcp 65001 怎么选？

面对两种最主流的非代码修改类解决方案（PYTHONUTF8=1 与 chcp 65001），开发者常常疑惑究竟应当选择哪一种。两者的核心差异在于作用层级与受影响的程序范围：

为什么不建议使用 Windows“Beta 版: 使用 Unicode UTF-8 提供全球语言支持”？

在 Windows 区域设置中，有一个系统级的 Beta 选项能够将整机的默认 ANSI 代码页强行设定为 UTF-8。虽然这可以一次性解决 Python 乱码，但会带来严重副作用：许多国内传统的桌面软件、财务软件、EDA 设计工具或基于老旧 MFC/VB 编写的工具，其底层高度依赖 GBK 编码进行本地路径计算或注册表存储。开启该全局选项后，这类老软件极易大面积出现乱码、弹窗报错乃至闪退。因此，保持系统默认区域不变，在进程或会话局部按需切换 UTF-8 才是兼顾兼容与稳定的专业做法。

五、常见场景与应对速查

为便于在日常开发中迅速定位，下表与速查卡片整理了四类最频繁出现的乱码场景及最佳解决路线：

六、验证与结果确认

完成相关配置后，你可以创建一个名为 verify_encoding.py 的简短脚本，用于检验控制台当前环境是否已彻底解决乱码：

import sys
import locale

print("=== Python 编码环境检测 ===")
print("文件系统默认编码 :", sys.getfilesystemencoding())
print("标准输出流编码   :", sys.stdout.encoding)
print("系统首选区域设置 :", locale.getpreferredencoding())
print("-" * 32)
print("中文输出测试: 你好，世界！")
print("符号与标点测试: 『特别测试』· ￥100 — 顿号、书名号")
print("Emoji 与多语言: 🚀 Python 编程 (UTF-8 状态良好)")

在控制台中运行该脚本：

python verify_encoding.py

如果输出中的中文字符、特殊标点与 Emoji 均清晰完整展示，且 sys.stdout.encoding 显示为 utf-8，即证明当前控制台的 Python 中文输出链路已处于完全正常的状态。