Windows11下pytest与python -m pytest行为差异及sys.path问题咨询

现象是否正常？ #

这个现象是完全正常的，两种调用pytest的方式本身就存在执行上下文的差异，导致sys.path[0]的取值不同。

原因分析 #

1. 直接运行pytest命令 #

你调用的是独立的pytest.exe可执行程序，它在启动时会自动扫描并识别Python项目的根目录（通常是包含setup.py、pyproject.toml或__init__.py的目录），并将这个根目录设置为sys.path[0]。在你的场景中，pytest识别到的项目根是c:\coding，因此输出该路径。

2. 运行python -m pytest命令 #

这种方式是通过Python解释器以模块模式加载并运行pytest，此时Python会直接将当前工作目录（也就是你执行命令的c:\coding\example）添加到sys.path的首位，所以sys.path[0]就是当前工作目录。

使pytest行为与python -m pytest一致的方法 #

方法一：通过配置文件指定项目根 #

在c:\coding\example目录下创建pyproject.toml文件，添加以下内容：

[tool.pytest.ini_options]
testpaths = ["tests"]

之后直接运行pytest时，pytest会自动将当前目录c:\coding\example识别为项目根，sys.path[0]的输出就会和python -m pytest一致。

方法二：运行时指定根目录参数 #

在c:\coding\example目录下执行命令时，显式指定项目根目录：

pytest --rootdir=c:\coding\example

这种方式可以临时覆盖pytest自动识别的根目录。

方法三：直接使用python -m pytest #

这是最直接的解决方案，直接采用模块模式运行pytest，天然保持当前工作目录作为sys.path[0]的取值。

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