解决Python3脚本中文乱码问题：编码声明与控制台设置

一、中文乱码的本质与发生节点

Python 3在语言内核层面已经全面采用Unicode（字符串类型为 str）。这意味着脚本内部处理字符本身并不会发生混乱。乱码和编码报错通常只发生在“输入/输出”的转码边界上：

• 源码读取阶段（解码）：Python解释器从硬盘读取 .py 文本文件时，需要将其从字节序列（bytes）转换为内存中的Unicode字符。如果文件以GBK保存，解释器却按UTF-8解码，或者文件声明了UTF-8却被编辑器强行存为ANSI，就会在源码加载时报错或产生乱码。
• 控制台输出阶段（编码）：当脚本调用 print() 输出内容时，系统需要将Unicode字符重新编码为字节流传给终端（stdout）。Windows系统的控制台（CMD / PowerShell）默认使用代码页CP936（GBK编码）。如果输出中包含了GBK字符集未收录的符号（如特殊标点、Emoji或部分生僻汉字），就会触发 UnicodeEncodeError；若解释器强行输送了UTF-8字节流而终端仍按GBK解码，便会呈现典型的乱码。

图 1：Python 3 数据流转模型与两个核心乱码节点

二、第一道关卡：源码编码声明规范（PEP 263）

在Python 3中，源代码的默认编码被正式定义为 UTF-8。这意味着在绝大多数现代编辑器中，只要将文件保存为UTF-8编码，即使不写任何编码声明，中文字符串常量也能被正常解析。

然而，显式添加编码声明依然是工程实践中的最佳保障。它的核心价值在于：

1. 防御旧环境或非标准运行环境：某些嵌入式Python环境、特定CI/CD构建容器或第三方解释工具链仍可能默认采用系统的本地编码（如Windows下的ANSI）。
2. 强制规范团队代码规范：通过符合PEP 263标准的声明，能明确告知协作人员和静态分析工具此文件使用UTF-8编码。

标准的编码声明写法

编码声明必须放置在脚本的第一行或第二行（第一行常用于 #!/usr/bin/env python3 这类Shebang声明）：

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

# 此时直接定义中文字符串是完全合法的
message = "你好，Python 3 中文输出测试"
print(message)

三、第二道关卡：Windows 控制台与终端代码页设置

即使源码文件与编码声明完全规范，在Windows系统的CMD或PowerShell中执行脚本时，仍有很大概率遇到中文乱码或 UnicodeEncodeError。这是由Windows控制台历史遗留的代码页机制所导致的。

1. 诊断当前控制台代码页

在CMD或PowerShell窗口中，运行以下命令即可查看当前活动代码页：

chcp

如果输出为 活动代码页: 936，代表当前终端正在以GBK（CP936）方式解码程序输出。当Python脚本输出GBK字符集之外的字符（例如一些繁体汉字、Emoji图标 🎉 或特殊技术符号）时，Python标准库就会报错中断。

2. 将控制台切换为 UTF-8（代码页 65001）

在执行Python脚本之前，可先在终端执行：

chcp 65001

执行后控制台切换为UTF-8解码模式。此时再运行输出UTF-8的Python脚本，中文字符即可正常显示。

四、第三道关卡：Python 运行时标准输出流的编码控制

在很多自动化脚本或跨平台部署场景下，我们不能依赖手动去执行 chcp 65001。更优雅、更彻底的方案是让Python在运行时自适应或显式配置标准输出流（sys.stdout）的编码。

方案 A：使用 sys.stdout.reconfigure（推荐方案，Python 3.7+）

这是官方在Python 3.7中引入的标准API，无需修改外部环境变量，直接在脚本最顶层重新配置输出流编码与错误容忍策略：

import sys

# 重新配置标准输出与标准错误流的编码
sys.stdout.reconfigure(encoding='utf-8')
sys.stderr.reconfigure(encoding='utf-8')

print("无论控制台默认代码页是什么，均以 UTF-8 编码向终端输出中文。")

若运行环境控制台极其特殊且无法显示某些生僻字，还可以指定 errors='backslashreplace' 或 errors='ignore'，保证核心进程不崩溃：

sys.stdout.reconfigure(encoding='utf-8', errors='replace')

方案 B：配置环境变量 PYTHONIOENCODING

如果不希望改动脚本源代码，可以通过设置 PYTHONIOENCODING 环境变量来改变Python标准输入输出流的默认编码。

Windows 命令提示符 (CMD)：

set PYTHONIOENCODING=utf-8
python your_script.py

Windows PowerShell：

$env:PYTHONIOENCODING="utf-8"
python your_script.py

方案 C：启用 Python UTF-8 Mode（参数 -X utf8）

Python 3.7引入了PEP 540定义的UTF-8模式。在此模式下，Python将忽略操作系统的locale区域设置，强行将默认编码、标准流及文件系统接口全部设为UTF-8：

python -X utf8 your_script.py

五、常见方案对比与选择建议

不同场景对解决方案的侵入性和作用范围要求不同。下表与图示清晰对比了各方案的优缺点：

图 2：主流中文编码解决方案特性与适用场景对比

六、标准解决步骤与操作流程

当在新电脑或新服务器上首次运行Python脚本遇到中文乱码时，按照以下四个标准步骤逐项推进即可快速定位并彻底根除问题：

图 3：四步排查与解决中文乱码的标准操作流

环境自检与验证脚本

以下是一个可直接运行的诊断脚本。将此代码保存为 check_encoding.py，在终端中执行以打印当前环境的所有关键编码状态：

# -*- coding: utf-8 -*-
import sys
import locale

print("=== Python 编码环境自检 ===")
print("Python 版本        :", sys.version.split()[0])
print("默认文件系统编码   :", sys.getfilesystemencoding())
print("默认字符编码       :", sys.getdefaultencoding())
print("系统区域首选编码   :", locale.getpreferredencoding())
print("标准输出 (stdout)  :", sys.stdout.encoding)
print("标准错误 (stderr)  :", sys.stderr.encoding)
print("--------------------------")
test_str = "中文测试：春水碧于天，画船听雨眠。包含符号: 【】¥ 💡"
print("测试字符串正常输出 :", test_str)

预期正常输出示例（在已配置好的UTF-8环境下）：

=== Python 编码环境自检 ===
Python 版本        : 3.10.8
默认文件系统编码   : utf-8
默认字符编码       : utf-8
系统区域首选编码   : cp936
标准输出 (stdout)  : utf-8
标准错误 (stderr)  : utf-8
--------------------------
测试字符串正常输出 : 中文测试：春水碧于天，画船听雨眠。包含符号: 【】¥ 💡

七、故障场景排查与速查总结

如果在实际开发中遇到具体的报错或显示异常，可参考下方的速查决策矩阵进行针对性修复：

图 4：Python 3 常见中文异常现象与速查决策卡

归纳而言，在现代Python 3开发中规避中文乱码的核心口诀只有一条：“源码存UTF-8，首行明声明；流重构UTF-8，终端统一六五零零一（65001）”。只要在程序生命周期的解码入口与编码出口做到明确定义，就能在任意平台与终端下保持中文输出的稳定与清晰。