python无中文版，需统一源码（utf-8声明）、终端（chcp 65001或reconfigure）、文件i/o（显式encoding）、http响应（r.encoding）、系统locale及第三方库编码设置，六者不一致导致乱码。
Python 本身没有“中文版”概念，所谓“改为中文版”实际是调整终端、IDE 或程序运行时的字符编码与区域设置，让中文能正常显示、输入和处理。核心问题不是换语言包，而是解决 UnicodeDecodeError、乱码、locale.getpreferredencoding() 返回 'cp936'（Windows）或 'UTF-8'（Linux/macOS）不一致等现象。
Python 脚本内强制使用 UTF-8 编码
很多中文乱码源于源文件保存编码与解释器读取编码不匹配。即使系统 locale 是中文，Python 默认仍按字节流读取文件，不自动识别 BOM 或声明。
- 所有
.py文件开头必须加编码声明：# -*- coding: utf-8 -*-
- 该声明必须位于文件前两行，且不能被注释或空行隔开
- 用编辑器（如 VS Code、PyCharm）确认文件实际保存为 UTF-8 —— 不要依赖“无 BOM 的 UTF-8”，有 BOM 更稳妥（尤其 Windows）
- 避免用记事本另存为 UTF-8：它默认加 BOM，而 Python 3.12+ 对带 BOM 的 UTF-8 声明会报
SyntaxError；推荐用 VS Code 手动选 “Save with Encoding → UTF-8”
Windows 下控制台输出中文不乱码（cmd / PowerShell）
Windows 默认控制台编码是 cp936（GBK），而 Python 3 默认用 UTF-8 字符串，直接 print('你好') 会触发 UnicodeEncodeError。
- 临时方案：启动 Python 前执行
chcp 65001切换控制台到 UTF-8 模式 - 永久方案（不推荐改系统）：在脚本开头加
import sys sys.stdout.reconfigure(encoding='utf-8')
（仅 Python 3.7+） - 兼容旧版本：用
print('你好'.encode('utf-8').decode(sys.stdout.encoding or 'utf-8', errors='ignore'))过于繁琐，不如统一用chcp 65001 - PowerShell 中若仍乱码，需在 PowerShell 设置里勾选“使用旧版控制台”，否则 Unicode 支持不稳定
locale 模块返回中文地区但 print() 仍出错？检查 sys.stdout.encoding
locale.getdefaultlocale() 返回 ('zh_CN', 'cp936') 并不保证 Python I/O 流就用该编码 —— 实际以 sys.stdout.encoding 为准，它由终端环境决定，不受 Python 内部 locale 设置影响。
立即学习“Python免费学习笔记（深入）”；
- 运行
import sys; print(sys.stdout.encoding)
查看真实编码，常见值：'utf-8'（WSL/Linux/macOS）、'cp936'（Windows cmd 未切编码）、'None'（重定向到文件或管道时） - 若为
None，说明输出被重定向，此时print()会 fallback 到locale.getpreferredencoding()，但该值可能仍是cp936，导致写入 UTF-8 文件时出错 - 安全写法：显式指定输出编码
with open('out.txt', 'w', encoding='utf-8') as f: print('你好', file=f)
第三方库（如 requests、pandas）读写中文路径/内容失败
这类问题常被误认为“Python 不支持中文”，实则是底层 C 库或操作系统 API 对宽字符路径支持不足，或库未正确传递 encoding 参数。
-
requests.get()返回中文网页内容：务必检查r.encoding，它可能被错误推断为'ISO-8859-1'；应设为r.encoding = 'utf-8'或用r.content.decode('gbk')（针对国内网站） -
pandas.read_csv('数据.csv')报错：Windows 下中文路径通常没问题，但若含 Unicode 字符（如 emoji 或生僻字），建议用pathlib.Path构造路径，并显式传encoding='utf-8' - 调用
subprocess.run()执行含中文参数的命令：Windows 上需确保shell=True且终端已chcp 65001；Linux/macOS 一般无问题，但注意env中不要覆盖LANG或LC_ALL
真正卡住人的往往不是“怎么设中文”，而是没意识到：Python 解释器、源文件编码、终端编码、文件系统路径编码、HTTP 响应头声明、第三方库默认行为——这六者可以各自不同。逐项查 sys.stdout.encoding、open().encoding、r.apparent_encoding、locale.getpreferredencoding()，比盲目改 registry 或装“中文版 Python”有效得多。
