如何通过Bazel针对不同Python版本测试同一代码库？

用Toolchain切换运行同一测试目标 #

先确保你已经通过python_register_toolchain正确注册了两个目标Python版本，比如3.8和3.10。每个注册动作会生成对应的toolchain集合目标，比如@python38//:all_toolchains和@python310//:all_toolchains。

运行测试时，直接通过--extra_toolchains参数指定要使用的toolchain即可：

• 用Python 3.8跑测试：

  bazel test //path/to:your_test --extra_toolchains=@python38//:all_toolchains
  

• 用Python 3.10跑测试：

  bazel test //path/to:your_test --extra_toolchains=@python310//:all_toolchains
  

嫌每次输参数麻烦的话，直接在.bazelrc里配置别名：

test:py38 --extra_toolchains=@python38//:all_toolchains
test:py310 --extra_toolchains=@python310//:all_toolchains

之后就能用简化命令切换版本：

bazel test //path/to:your_test --config=py38
bazel test //path/to:your_test --config=py310

批量跑多版本测试 #

如果要一次性验证所有版本的兼容性，可以写个简单的shell脚本循环调用不同配置的测试命令，或者用Bazel的test_suite把多版本测试打包成一个目标，不过脚本方式更灵活。

除了Bazel测试，还有几种方式提前排查兼容性问题：

• 用pyupgrade扫描代码：指定目标Python版本后，它能自动找出过时语法（比如%格式化、废弃的print语句），还能帮你自动升级部分代码。
• 静态检查工具增强：给pylint或flake8配置目标Python版本，比如在pyproject.toml里指定python-version = "3.10"，它们会检测出对应版本不支持的语法、函数调用。
• 检查依赖兼容性：用pip-check-reqs查看项目依赖是否支持目标Python版本，或者直接看PyPI上依赖包的版本说明，优先选择兼容目标版本的包。
• 小范围手动验证：先在目标Python环境下跑核心模块的单元测试，快速定位明显的问题（比如依赖库缺失、语法报错），再扩大测试范围。

内容的提问来源于stack exchange，提问作者Ibolit