如何解决Python测试中因编码格式导致的乱码报错_在pytest中强制UTF-8-Python教程-PHP中文网

pytest中文乱码本质是编码不一致导致的显示异常，需从源文件utf-8保存与声明、运行环境（如windows设pythonioencoding=utf-8）、插件写入逻辑（如pytest-html的write_text加encoding='utf-8'）三处统一解决。

如何解决python测试中因编码格式导致的乱码报错_在pytest中强制utf-8

Pytest 中的中文乱码不是“报错”，而是输出或保存时编码不一致导致的显示异常，pytest 本身不会因中文抛出 SyntaxError 或 UnicodeDecodeError（除非源文件本身保存为非 UTF-8 编码且未声明）。真正要强制 UTF-8，得从三处下手：源文件、运行环境、插件写入逻辑。

确保测试文件以 UTF-8 保存且声明编码

这是最基础但常被跳过的一步。即使你写了中文 ids 或 docstring，如果文件实际是 GBK 编码保存的，Python 解释器读取时就会失败。

用 VS Code / PyCharm 打开测试文件，右下角查看当前编码，点击切换为 UTF-8，并选择「通过编码重新打开」
在文件首行添加 PEP 263 声明：# -*- coding: utf-8 -*-（虽然 Python 3 默认 UTF-8，但显式声明能避免某些编辑器/IDE 误判）
不要依赖记事本保存——它默认用 GBK，极易埋雷

设置运行时环境编码（Windows 尤其关键）

Windows 控制台默认使用 cp936（GBK），pytest 捕获 stdout/stderr 时若未指定编码，就可能把 UTF-8 字节流按 GBK 解码，造成双重乱码（如 åä¸ª）。

python-parallelization

将顺序 Python 代码转换为并行/并发实现，用于在需要并行化 Python 代码、提升性能时使用。

下载

运行前临时设置：set PYTHONIOENCODING=utf-8（Windows CMD）或 $env:PYTHONIOENCODING="utf-8"（PowerShell）
更稳妥的是在 pytest.ini 中加：
```
[pytest]
addopts = --tb=short
python_files = test_*.py
# 强制输出编码
console_output_style = utf-8
```
（注意：console_output_style 是 pytest 7.0+ 支持的选项；旧版本可改用 --outputencoding=utf-8，但该参数在 7.0 后已弃用）
CI 环境（如 Jenkins）需在构建步骤中显式设置环境变量，不能只靠本地终端

修复 pytest-html 的 write_text 编码硬编码

pytest-html 3.2.0 及之前版本在 Windows 下默认用系统编码（GBK）写文件，self.logfile.write_text(...) 不带 encoding 参数，直接导致 HTML 文件头部是 UTF-8 内容、但文件本身是 GBK 编码，浏览器解析失败。

找到插件路径：python -c "import pytest_html; print(pytest_html.__file__)"，定位到 html_report.py

搜索 _save_report 方法，在所有 write_text 调用后加 encoding='utf-8'：

self.logfile.write_text(report_content, encoding='utf-8')
style_path.write_text(self.style_css, encoding='utf-8')

同理检查 result.py 中涉及字符串拼接生成 nodeid 或 name 的地方，避免先 encode('utf-8') 再 decode('unicode_escape') 这类多余转换——这会把原本正常的中文变成 u82f9u679c

conftest.py 钩子中慎用 encode/decode 链式操作

网上流传的 item.name.encode().decode('unicode_escape') 是典型“以毒攻毒”：它假设原始字符串已是 Unicode 转义形式，但实际多数情况是正常中文字符串。强行 decode 会抛 UnicodeDecodeError 或静默损坏。

先判断是否含 u 转义：if '\u' in item.name: 再做解码

更安全的做法是只处理 nodeid 中明确被转义的部分，例如：

if '[' in item.nodeid and ']' in item.nodeid:
    parts = item.nodeid.split('[', 1)
    if len(parts) == 2:
        id_part = parts[1].rstrip(']')
        try:
            item._nodeid = f"{parts[0]}[{id_part.encode().decode('unicode_escape')}]"
        except UnicodeDecodeError:
            pass