Python 3.15 的一个重要变化正在预览：UTF-8 模式将成为默认行为。对跨平台程序来说，这能减少 Windows、Linux 和 macOS 之间因本地编码不同而产生的差异；但对依赖系统默认编码的旧代码来说，也意味着需要提前测试。
这次变化最值得关注的地方，不是“UTF-8 更流行”，而是过去那些没有显式写出 encoding 的文件读写代码，运行结果可能会发生变化。现在可以用预发布版本验证项目，并逐步把关键 I/O 改成明确、可移植的写法。
变化会影响哪些代码
下面这种代码依赖运行环境的默认文本编码：
with open("config.txt", "r") as file:
config = file.read()
在不同操作系统、终端或 locale 设置下，默认编码可能不同。文件中一旦出现中文、日文、欧洲语言字符或特殊符号，就可能触发 UnicodeDecodeError，或者更隐蔽地读出错误内容。
Python 3.15 预览的方向是让 UTF-8 成为默认模式，从而减少这类平台差异。不过，“默认是 UTF-8”并不代表应该删除所有显式编码声明。对于配置文件、协议文件、日志交换文件和持久化数据，明确写出编码仍然更容易审查和维护。
推荐把业务代码改成这样：
from pathlib import Path
config_path = Path("config.txt")
# 读取由程序生成或约定为 UTF-8 的文本
config = config_path.read_text(encoding="utf-8")
# 写回时同样明确指定 UTF-8
config_path.write_text(config.rstrip() + "\n", encoding="utf-8")
print(f"处理完成：{config_path}")
这段代码不依赖操作系统的 locale，适合放进命令行工具、CI 流程和跨平台桌面程序中。
用 Python 3.15 预发布版本做一次兼容性检查
预发布版本适合在隔离环境中测试，不建议直接替换生产环境的 Python。确认本机已经安装对应的 Python 3.15 预览版本后，可以创建独立虚拟环境：
python3.15 --version
python3.15 -m venv .venv-315
# Linux/macOS
. .venv-315/bin/activate
# Windows PowerShell 可改用：
# .venv-315\Scripts\Activate.ps1
python -m pip install -U pip
python -m pytest
如果项目没有测试套件，也可以先运行一个最小检查脚本。保存为 check_utf8.py：
from pathlib import Path
import locale
import sys
import tempfile
print("Python:", sys.version.split()[0])
print("UTF-8 mode:", sys.flags.utf8_mode)
print("Preferred encoding:", locale.getpreferredencoding(False))
with tempfile.TemporaryDirectory() as directory:
path = Path(directory) / "message.txt"
expected = "你好，Python 3.15 🚀"
path.write_text(expected, encoding="utf-8")
actual = path.read_text(encoding="utf-8")
assert actual == expected
print("Explicit UTF-8 I/O: OK")
运行：
python check_utf8.py
如果要比较显式编码和默认编码的行为，可以使用一个单独的实验脚本：
from pathlib import Path
import tempfile
with tempfile.TemporaryDirectory() as directory:
path = Path(directory) / "sample.txt"
path.write_bytes("你好，UTF-8\n".encode("utf-8"))
with path.open("r", encoding="utf-8") as file:
print("explicit:", file.read().strip())
with path.open("r") as file:
print("default:", file.read().strip())
在 Python 3.15 预览版本中，可以分别测试默认模式和关闭 UTF-8 模式的结果：
python3.15 -X utf8 check_default_io.py
python3.15 -X utf8=0 check_default_io.py
第二条命令用于模拟不启用 UTF-8 模式的环境。它不是对所有历史运行环境的完整复现，但能帮助发现那些依赖默认编码的代码路径。
项目迁移时，优先处理这几类位置
1. 文本文件读写
搜索项目中的 open(、Path.read_text() 和 Path.write_text()，为确定格式的文本文件加上 encoding="utf-8"。如果文件来自外部系统，先确认对方的编码约定，不要仅凭文件扩展名判断。
2. CSV、JSON 和模板文件
这些文件通常应使用 UTF-8，但库调用仍然要看具体 API。例如打开 CSV 文件时：
import csv
with open("users.csv", "r", encoding="utf-8", newline="") as file:
for row in csv.DictReader(file):
print(row["name"])
newline="" 是 CSV 文档常见的推荐设置，避免换行处理和 CSV 模块的逻辑互相干扰。
3. 子进程和标准输入输出
文件编码变化只是其中一部分。程序如果通过管道、重定向或子进程交换文本，还要检查 subprocess、sys.stdin、sys.stdout 和日志处理逻辑。对于稳定的外部协议，优先使用明确的字节到文本转换，而不是假设所有环境都使用同一种 locale。
4. 测试夹具和构建脚本
很多编码问题只存在于测试数据、打包脚本或文档生成器中。把非 ASCII 内容加入 CI 测试，并在 Linux 和 Windows 环境各运行一次，比只依赖开发机上的默认设置更可靠。
默认 UTF-8 不是“可以忽略编码”的信号
这项变化会降低跨平台运行的意外差异，但也可能让旧程序表现得不同。例如：
- 程序过去依赖本地编码读取某个历史文件；
- 文件实际使用的是一种地区编码，而不是 UTF-8；
- 某些第三方库内部仍然使用自己的编码默认值；
- 生成的文件需要与只接受特定编码的旧系统对接。
遇到这类场景，应在边界处明确编码。例如，外部系统要求某种传统编码时，可以写成：
from pathlib import Path
legacy_text = Path("legacy.txt").read_text(encoding="cp1252")
Path("normalized.txt").write_text(legacy_text, encoding="utf-8")
编码转换最好集中在输入和输出边界完成，核心业务逻辑内部尽量只处理已经解码的 Python 字符串。
一份可执行的检查清单
- 在隔离环境中安装并运行 Python 3.15 预发布版本。
- 搜索没有
encoding参数的文本文件操作。 - 为 UTF-8 文件显式指定
encoding="utf-8"。 - 为外部系统的历史编码写出真实的编码名称，不要依赖默认值。
- 在 CI 中加入中文、emoji 和非 ASCII 路径测试。
- 检查 CSV、JSON、日志、模板、子进程和标准输出等边界。
- 用
-X utf8=0做对照测试，定位依赖默认编码的代码。
Python 3.15 的 UTF-8 默认值可以减少平台差异，但真正可移植的代码仍然需要清楚地表达数据格式。现在用预发布版本跑一轮测试，并把关键 I/O 的编码写明白，通常比等到正式升级后再排查字符集问题成本更低。