HTMLTestRunner 在 Python 3.8+ 报 StringIO 导入错误，因原版为 Python 2 编写；应改用 pip install html-testRunner（连字符），导入为 import HtmlTestRunner，并确保测试类继承 unittest.TestCase、方法以 test_ 开头。
HTMLTestRunner 为什么在 Python 3.8+ 直接报 ImportError: No module named 'StringIO'
因为原版 HTMLTestRunner 是为 Python 2 写的，硬编码用了已移除的 StringIO 模块，且没适配 unittest 新的测试发现机制。
- 别 pip install HTMLTestRunner —— 那是 Python 2 版，PyPI 上多数同名包都不支持 3.7+
- 改用社区维护的兼容分支：
pip install html-testRunner（注意连字符，不是下划线） - 导入时写
import HtmlTestRunner（首字母大写，类名也是HtmlTestRunner.HTMLTestRunner） - 它内部已把
StringIO替换为io.StringIO，并修复了sys.stdout编码、addSuccess签名等兼容问题
生成报告时中文乱码或测试用例名显示为 <bound method ...>
根本原因是测试用例对象没正确转成字符串描述，加上默认编码未设为 UTF-8，HTML 输出时直接丢了原始字符。
- 确保测试类继承自
unittest.TestCase，且每个测试方法以test_开头；否则HtmlTestRunner无法提取有效名称 - 运行命令加
-u参数（如python -u run_tests.py），强制 stdout 使用 UTF-8 - 初始化 runner 时显式指定
report_title和description，避免空值触发内部异常逻辑 - 示例关键行：
runner = HtmlTestRunner.HTMLTestRunner(output='reports', report_name='smoke_test', report_title='冒烟测试报告', verbosity=2)
报告里没有截图、日志或自定义断言失败详情
HtmlTestRunner 默认只捕获 self.assertEqual 等标准断言抛出的异常信息，不会自动抓取 print()、日志或 Selenium 截图 —— 这些得手动塞进测试方法的异常上下文里。
- 在
except块中用self.fail(str(e) + '\n' + screenshot_base64)把截图嵌进失败消息（base64 要先转成 img 标签字符串） - 想让日志出现在报告里？在
setUp中设置logging.basicConfig(level=logging.INFO, format='%(message)s')，再重定向到self.log_buffer = io.StringIO()，最后在tearDown中把 buffer 内容 append 到失败信息里 - 注意：不要在
tearDown里调用self.driver.quit()后还试图截图，会报WebDriverException
用 pytest 运行但想输出 HTMLTestRunner 格式报告
不行。pytest 和 unittest 的测试加载器、结果收集器完全不兼容，HtmlTestRunner 只认 unittest.TestSuite 实例，对 pytest.main() 返回值无感知。
立即学习“Python免费学习笔记（深入）”；
- 要么全切回
unittest框架（推荐，尤其已有大量 TestCase 类） - 要么换用 pytest 原生生态的报告工具，比如
pytest-html（pip install pytest-html，运行加--html=report.html） - 强行桥接？可以写个 wrapper 把 pytest 收集到的 test items 转成
unittest.TestCase子类实例，但极容易丢掉 fixture、参数化和 hook 行为，不建议
HtmlTestRunner 对测试组织方式有强约束：它只信任 unittest 的生命周期和断言模型，任何绕过它的日志、截图、清理逻辑，都得手工“塞”进那个失败字符串里。 
