GitLab CI+Pytest场景下，tox中setenv与passenv的区别及适用场景

核心差异 #

• setenv：主动给 tox 虚拟环境设定/覆盖环境变量，值是你明确写死或者用 tox 内置变量生成的，和外部环境无关。
• passenv：把 tox 运行所在的外部环境（比如你 GitLab CI 的宿主环境）里已有的变量，直接“透传”到虚拟环境中，相当于让虚拟环境继承外部的变量值。

什么时候用哪个？ #

选 setenv 的场景 #

1. 不管外部环境是什么，都要强制用固定值的时候。比如测试时统一用内存数据库：

[testenv]
setenv =
    DB_URL=sqlite:///:memory:

2. 需要用 tox 自己的内置变量（比如 {envpython}、{toxworkdir}）来构造变量值的时候：

[testenv]
setenv =
    PYTHONPATH={toxworkdir}/src

选 passenv 的场景 #

这刚好匹配你现在 GitLab CI 的需求：

1. 要把 GitLab CI 里的预定义变量（比如 CI_PROJECT_DIR、CI_JOB_ID）或者你在 .gitlab-ci.yml 里自定义的变量（比如 TEST_ENV=staging）传到虚拟环境里时。配置示例：

[testenv]
passenv =
    CI_PROJECT_DIR
    TEST_ENV

2. 外部变量值是动态变化的，你不想在 tox.ini 里硬编码，直接复用外部的值就行。比如 GitLab CI 的变量会跟着流水线变，用 passenv 就能自动拿到最新值。

可以混合用吗？ #

当然可以。如果既有需要固定的变量，又要透传外部变量，同时配置就行：

[testenv]
setenv =
    DB_URL=sqlite:///:memory:
passenv =
    CI_PROJECT_DIR
    TEST_ENV

这样虚拟环境里会同时有你固定的 DB_URL，以及从 GitLab CI 透传过来的那两个变量。

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