Python在Windows 11下中文路径报错的根本原因是解释器启动时未用UTF-8解码路径，必须在进程启动前设置PYTHONUTF8=1环境变量，并确保源文件为UTF-8无BOM编码、终端代码页为65001，且pytest扫描范围避开中文路径。
直接说结论：Python 在 Windows 11 下遇到中文路径报错（比如 UnicodeDecodeError: 'gbk' codec can't decode byte 或 [Errno 2] No such file or directory），不是你代码写错了，而是 Python 解释器启动时没用 UTF-8 解码系统路径——关键得在进程启动前就让它“认得中文”。
设置 PYTHONUTF8=1 环境变量（最有效）
这是 Python 3.7+ 原生支持的开关，强制解释器全程使用 UTF-8 处理文件系统路径、命令行参数和环境变量。它比改 sys.setdefaultencoding 或临时设 os.environ 可靠得多，因为后者根本来不及干预路径解析阶段。
- Windows CMD：运行 pytest 前先执行
set PYTHONUTF8=1，再跑python -m pytest - PowerShell：执行
$env:PYTHONUTF8="1"，然后运行命令 - PyCharm：进
Run → Edit Configurations → Environment variables，加一行PYTHONUTF8=1；同时勾选Add content root to PYTHONPATH - Git Bash：在
~/.bashrc里加export PYTHONUTF8=1，重启终端
验证是否生效：运行 python -c "import sys; print(sys.getfilesystemencoding())"，输出必须是 utf-8（不是 mbcs 或 cp936）。
确保所有源文件是 UTF-8 无 BOM 编码
哪怕环境变量设对了，如果 conftest.py、pyproject.toml 或某个 test_*.py 文件本身是 GBK 或带 BOM 的 UTF-8，pytest 加载时仍会崩。这不是路径问题，是文件内容读取失败。
立即学习“Python免费学习笔记（深入）”；
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
- VS Code：右下角点击编码名 → 选择
Save with Encoding → UTF-8（别选 “UTF-8 with BOM”） - PyCharm：File → Settings → Editor → File Encodings → 全局编码、项目编码、默认编码都设为
UTF-8，且取消勾选Transparent native-to-ascii conversion - 记事本：另存为时手动选
UTF-8（不是 ANSI 或 Unicode）
特别注意：pyproject.toml 如果含中文注释或值（如 testpaths = ["测试"]），也必须是 UTF-8 无 BOM，否则 TOML 解析器会直接报错。
避免 pytest 自动扫描含中文的父目录
pytest 默认从当前目录递归找测试文件。如果你在 D:\我的项目\ 下执行，它会尝试打开 D:\我的项目\venv\Lib\site-packages\... 里的所有 .py 文件——而这些路径里很可能有中文用户名（如 C:\Users\张三\...），触发解码失败。
- 在
pyproject.toml中显式限定范围：[tool.pytest.ini_options] testpaths = ["tests"] python_files = ["test_*.py"] python_classes = ["Test*"]
- 确保
tests/目录本身路径不含中文（例如放在D:\proj\tests，而不是D:\我的项目\tests） - 运行时用绝对路径指定入口：
python -m pytest D:\proj\tests\test_demo.py，不依赖当前工作目录
这个配置不能解决编码底层问题，但能大幅减少触发点——很多报错其实就卡在扫描非目标路径这一步。
终端编码也要同步（chcp 65001）
即使 Python 解释器用了 UTF-8，CMD 或 PowerShell 终端本身还是默认 GBK（chcp 936），导致你看到的错误信息乱码，甚至输入的中文参数被截断。这不是 Python 的锅，但会让你误判问题。
- CMD 启动后立即执行
chcp 65001（切换到 UTF-8 代码页） - PowerShell 默认已支持 UTF-8，但若异常，可运行
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8 - PyCharm 终端：Settings → Tools → Terminal → Shell path，勾选
Activate environment in shell并确认环境变量已继承
真正容易被忽略的是：这些设置必须全部在 Python 进程启动前就位。比如你在 Python 脚本里写 os.environ['PYTHONUTF8'] = '1'，完全无效——解释器已经按旧规则初始化完了。
