pytest通过--lang参数动态读取语言配置，用fixture按需加载对应yaml数据并断言翻译文案，ci中需预装locale、设编码、配浏览器参数确保环境一致。
pytest如何读取语言配置项
pytest本身不内置多语言支持，得靠配置文件或命令行参数把语言标识传进去。最稳妥的方式是用pytest_addoption注册自定义参数，比如--lang，再通过request.config.getoption在测试函数里拿到值。
常见错误是直接在conftest.py顶层读取os.environ或硬编码LANG='zh'——这会让所有测试共用一个语言，无法并行跑不同语言用例。
- 推荐做法：在
conftest.py中用parser.addoption('--lang', action='store', default='en') - 测试函数里用
lang = request.config.getoption('lang')，别用全局变量缓存 - 如果配合
pytest-xdist并发，必须确保每个worker都独立接收--lang参数，不能靠环境变量传递
测试数据怎么按语言动态加载
硬写多套test_login_en.py/test_login_zh.py是反模式。应该把文案抽成YAML/JSON文件，按语言目录组织，运行时根据--lang值加载对应路径下的数据。
容易踩的坑是路径拼接出错，比如os.path.join('data', lang, 'login.yml')在lang='zh-CN'时生成data/zh-CN/login.yml，但实际文件夹叫zh_CN，就报FileNotFoundError。
- 建议统一用
zh、en等BCP 47简写，避免横线或下划线混用 - 加载逻辑里加一层存在性校验：
if not Path(data_path).exists(): raise ValueError(f'Missing language data: {lang}') - 不要在
pytest_generate_tests里做IO操作（如读YAML），会拖慢参数化发现阶段；改用fixture延迟加载
断言文案时怎么避免硬编码字符串
直接写assert 'Login failed' in page.text会导致测试在中文环境下失败。得把期望文案也从语言包里取，和测试逻辑解耦。
典型错误是把翻译字典塞进测试类的class属性里，结果不同语言的测试实例互相污染——因为pytest默认复用class对象。
- 用
@pytest.fixture(scope='function')提供trans函数，每次测试新建翻译上下文 - 翻译函数内部根据当前
lang参数查messages[lang].get('login_error')，不是查messages['login_error'][lang]（后者难维护） - 断言写成
assert page.text.contains(trans('login_error'))，而不是assert '用户名或密码错误' in page.text
CI里跑多语言测试要注意什么
本地能跑通的pytest --lang=zh，放到CI可能因缺失字体、locale设置或字符编码失败。尤其Linux容器默认是C.UTF-8，不保证zh_CN.UTF-8可用。
错误现象包括：日志输出乱码、UnicodeEncodeError、甚至XPath匹配含中文的文本失败（底层库误判编码）。
- CI脚本开头加
locale -a | grep 'zh_CN\|en_US'确认locale存在，不存在就apt-get install locales && locale-gen zh_CN.UTF-8 - Python启动前设
export PYTHONIOENCODING=utf-8，防止print中文炸掉 - 如果用Selenium，Chrome启动参数加上
--lang=zh-CN和--disable-gpu（某些GPU驱动下locale不生效）
locale-gen，整个多语言测试就在CI上静默挂掉。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
