PyCharm中Python unittest可运行，终端运行报ImportError求助

Hey there, let's break down what's happening and fix this import issue once and for all:

What's Causing the Problem #

When you enable those two PyCharm settings (Add content roots to PYTHONPATH and Add source roots to PYTHONPATH), PyCharm automatically adds your project root (Project) and all your source directories (Controller, Model, etc.) to Python's module search path. But when you run tests in the terminal or disable those settings, Python only checks its default system paths and the directory you're executing the script from—so it can't locate your custom modules like Controller or Model.

Solutions to Try #

1. Quick Fix for Terminal Runs

If you need a temporary solution for running tests in the terminal, you can manually set the PYTHONPATH environment variable before executing your test script:

• Linux/macOS:

  export PYTHONPATH=/absolute/path/to/your/Project:$PYTHONPATH
  python Tests/someunittest.py
  

• Windows (Command Prompt):

  set PYTHONPATH=C:\absolute\path\to\Project;%PYTHONPATH%
  python Tests\someunittest.py
  

• Windows (PowerShell):

  $env:PYTHONPATH = "C:\absolute\path\to\Project;$env:PYTHONPATH"
  python Tests\someunittest.py
  

Alternatively, add a few lines at the top of your test file (Tests/someunittest.py) to dynamically add the project root to the path:

import sys
import os

# Get the path to the Project directory (one level up from Tests)
project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.append(project_root)

# Now you can import your modules normally
from Controller.test_controller import YourControllerClass
from Model.model import YourModelClass

2. Permanent Fix (Proper Python Package Structure)

For a more robust solution, structure your project as a formal Python package so it works everywhere—terminal, PyCharm without auto-settings, etc.:

1. Create a setup.py file in your Project directory with this content:

   from setuptools import setup, find_packages
   
   setup(
       name="your-project-name",
       version="0.1.0",
       packages=find_packages(),
   )
   

2. Open your terminal, navigate to the Project directory, and run:

   pip install -e .
   

This installs your project in "editable" mode, meaning Python will recognize your project's modules no matter where you run your tests from.

3. PyCharm Manual Path Configuration

If you want to keep using PyCharm without the auto-PYTHONPATH settings, manually add the project root to your interpreter's path:

• Go to File > Settings > Project: [Your Project Name] > Python Interpreter
• Click the gear icon next to the interpreter dropdown and select Show All
• Select your interpreter, then click the Show paths for the selected interpreter button (folder icon with a plus sign)
• Click the + button, navigate to your Project directory, and add it
• Apply the changes—now PyCharm will always include this path in the Python search list, even with those auto-settings disabled.

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