pytest如何识别待测试代码的导入路径？

核心原因：pytest的隐性路径注入机制 #

你遇到的问题本质是pytest在运行时会自动完成路径注入，即使你没手动配置，甚至看起来sys.path里没有对应路径——关键细节如下：

1. 打印sys.path的时机可能不对 #

pytest在导入测试文件之前就已经修改了sys.path。如果你的打印代码写在测试函数里，看到的是导入完成后的sys.path，并非pytest寻找cards包时的路径状态。

要验证这一点，把打印代码放在测试文件最顶部（导入语句之前）：

import sys
print("导入时的sys.path:", sys.path)
from cards import Card

此时打印的路径里，必然包含能找到cards包的目录（比如cards_proj/src）。

2. pytest的自动路径注入规则 #

pytest默认会把以下路径加入sys.path：

• 你运行pytest命令时的当前工作目录
• 测试文件所在目录的父级目录（取决于importmode参数，默认值prepend会优先注入）
• 若存在测试根目录（比如包含.git、pytest.ini的目录），其相关路径也会被自动注入

如果你的cards_proj是当前工作目录，pytest会自动把它加入sys.path，而src/cards作为常规包（存在__init__.py），Python会通过sys.path里的cards_proj找到src下的cards包——这是Python包的隐式查找规则，不一定需要src直接出现在sys.path里。

3. 其他隐性路径来源 #

• IDE自动配置：VSCode、PyCharm等IDE会自动把项目根目录、src目录加入sys.path，即使终端运行的环境没有这些配置。可以尝试在纯终端环境下运行pytest，看是否还能正常导入。
• PYTHONPATH环境变量：系统可能预先设置了PYTHONPATH，包含cards_proj/src目录。终端运行echo $PYTHONPATH（Linux/macOS）或echo %PYTHONPATH%（Windows）即可查看。
• 残留配置文件：即使删除了pyproject.toml，如果目录下还有pytest.ini、tox.ini等文件，里面可能配置了pythonpath = src，依然会生效。

验证步骤 #

1. 在测试文件最顶部添加sys.path打印代码，查看导入时的真实路径。
2. 脱离IDE，在终端直接运行pytest，验证导入是否依然正常。
3. 检查系统的PYTHONPATH环境变量。
4. 排查目录下是否有残留的pytest配置文件。

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