Python默认编码依赖系统locale而非UTF-8；sys.setdefaultencoding()危险且无效，因启动后即被删除，强行调用会破坏字符串处理；应通过PYTHONIOENCODING环境变量控制I/O编码，open()必须显式指定encoding='utf-8'。
Python 默认编码不是 UTF-8，而是依赖系统 locale；直接改全局编码不可靠，也不推荐硬编码覆盖。
为什么 sys.setdefaultencoding() 是个危险操作
这个函数只在 Python 启动初期有效，解释器初始化完成后就被删掉。如果在脚本里写 sys.setdefaultencoding('utf-8')，运行时会抛 AttributeError: module 'sys' has no attribute 'setdefaultencoding'。更麻烦的是，强行调用它可能破坏内部字符串处理逻辑，导致 str/bytes 混乱、json 解析失败或 open() 读写错乱。
- 它不是设计给用户调用的“配置接口”，而是 CPython 内部初始化用的临时钩子
- 即使绕过删除机制（比如 patch
sys模块），后续标准库行为可能不可预测 - 在 Docker、CI 环境或不同 Linux 发行版中，locale 差异会让这种 hack 表现不一致
真正起作用的：环境变量与启动参数
Python 解释器启动时会读取 PYTHONIOENCODING 和 LANG/LC_ALL，这才是影响 input()、print()、sys.stdin/stdout 编码的源头。
- Linux/macOS 下，在 shell 中执行前设好：
export PYTHONIOENCODING=utf-8，再跑python script.py - Windows 命令行可用：
set PYTHONIOENCODING=utf-8 - Dockerfile 中写：
ENV PYTHONIOENCODING=utf-8 - PyCharm 等 IDE 需在 Run Configuration → Environment variables 里手动添加
注意：PYTHONIOENCODING 只控制 I/O 流，默认不影响 open() —— 后者仍由系统 locale 决定，除非显式传 encoding 参数。
立即学习“Python免费学习笔记（深入）”；
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
open() 不指定 encoding 就容易出问题
Python 3 的 open() 在没给 encoding 参数时，会调用 locale.getpreferredencoding(False) 获取编码。很多中文 Windows 默认返回 gbk，一读含中文的 UTF-8 文件就报 UnicodeDecodeError: 'gbk' codec can't decode byte 0xe4 in position 0。
- 最稳妥做法：所有文本文件操作都显式写
encoding='utf-8' - 别依赖
io.TextIOWrapper的默认行为，哪怕本地测试通过，换环境就崩 - 用
pathlib.Path.read_text(encoding='utf-8')或.write_text(..., encoding='utf-8')更清晰
示例：with open('data.json', encoding='utf-8') as f: data = json.load(f) —— 这比靠环境变量“赌”编码安全得多。
项目级统一处理：pyproject.toml + sitecustomize.py 的边界
有人想用 sitecustomize.py 自动注入 encoding 设置，但它的作用范围有限：只影响当前 Python 安装的交互式环境和普通脚本，对 subprocess.Popen、打包后的可执行文件（如 PyInstaller）、或被其他解释器加载的模块无效。
-
pyproject.toml里的[tool.black]或[tool.isort]配置，只能约束代码风格，不改变运行时编码 - 真要全局干预，得改启动入口（比如封装一个 shell wrapper 脚本，先 export 再 exec python）
- 更现实的做法：在项目根目录放一个
setup-env.sh，文档里明确要求开发者 source 它
复杂点在于：编码问题从来不是单点配置能兜住的，它横跨环境、工具链、依赖库和文件来源。最容易被忽略的是——你读的文件本身是不是 UTF-8？用 file -i filename 或 VS Code 右下角编码提示确认，比调任何 Python 参数都管用。
