如何在pytest中执行类内测试？及测试未被识别问题排查

Hey there, let’s work through why your pytest isn’t picking up those class-based tests! You’ve already covered the basics (following naming conventions, using an empty __init__.py), so let’s dive into some less obvious checks to fix this:

First, let’s clear up the __init__.py concern #

Empty __init__.py files are completely fine—they only exist to mark a directory as a Python package, and you don’t need to add any code there for pytest to recognize tests. That’s not the root of your issue here.

Key Checks to Get Your Tests Recognized #

• Remove any custom __init__ method from your test class
  Pytest skips test classes that define their own constructor. If your test class looks like this:

  class TestMyFeature:
      def __init__(self):
          self.setup_value = 10
  

  Delete that __init__ method—pytest handles instantiating test classes automatically, so you don’t need to define it.

• Make sure you’re running pytest from the right directory
  If your project structure looks something like this:

  my_project/
      tests/
          __init__.py
          test_my_module.py
      src/
          ...
  

  Run pytest from the project root directory (my_project/), not inside the tests/ folder. Running from the wrong path can prevent pytest from scanning all test files properly.

• Confirm your pytest environment matches your project interpreter
  It’s common to have pytest installed in a different Python environment than the one you’re using for your project. Run these quick checks:

  1. pytest --version to see which pytest executable is being used
  2. which python (or where python on Windows) to confirm your active interpreter path
  3. pip list | grep pytest to ensure pytest is installed in your current environment

• Use pytest’s collect-only mode to debug discovery
  Run pytest --collect-only -v—this command lists all tests pytest finds without running them. Look for your test class and method in the output:

  • If they show up: The issue is likely with how you’re triggering tests (e.g., missing flags)
  • If they don’t show up: There’s a problem with discovery rules for that specific test

• Check for conflicting configuration files
  If you have a pytest.ini, setup.cfg, or tox.ini in your project, it might override default discovery rules. Look for settings like:

  • python_classes: Restricts which class names are treated as test classes
  • python_functions: Limits recognized test method names
  • testpaths: Restricts which directories pytest scans
    Temporarily rename these files (e.g., pytest.ini.bak) and run pytest --collect-only again to see if tests are detected.

• Target the test directly to isolate the issue
  Try running a specific test manually to see if pytest can find it:

  pytest tests/test_your_module.py::TestYourClass::test_your_method -v
  

  If this works, pytest can see the test, but automatic discovery is blocked by something else (like config or directory structure).

Final Note #

If none of these steps resolve the issue, sharing the output of pytest -v and a text-based breakdown of your directory structure would help narrow things down even faster!

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