“No module named” 错误是每个 Python 开发人员都会遇到的。让我们分解一下发生这种情况的原因以及如何在不同情况下修复它。

了解错误

当 Python 找不到你尝试导入的模块时，它会抛出 'ModuleNotFoundError'。这是它的样子：

Import Error: No module named 'requests'
# or
ModuleNotFoundError: No module named 'pandas'

常见原因和解决方案

1. 未安装模块

这是最常见的原因。以下是检查和修复它的方法：

# Check installed packages
pip list | grep requests  # Unix/Mac
pip list | findstr requests  # Windows

# Install the missing package
pip install requests

# For specific versions
pip install requests==2.28.1

如果您使用的是虚拟环境（您应该使用），请确保您已激活它：

# Windows
.\venv\Scripts\activate

# Unix/Mac
source venv/bin/activate

2. 错误的 Python 环境

系统可能有多个 Python 安装。以下是验证您正在使用哪一个的方法：

import sys
print(sys.executable)  # Shows which Python installation is running
print(sys.path)       # Shows where Python looks for modules

修复：为 Python 版本使用正确的 pip：

# For specific Python versions
python3.9 -m pip install requests
python3.10 -m pip install requests

# On Windows
py -3.9 -m pip install requests

3. 项目结构不正确

以下是导致导入问题的常见项目结构：

my_project/
│
├── src/
│   ├── __init__.py
│   ├── main.py
│   └── utils/
│       ├── __init__.py
│       └── helpers.py
│
└── tests/
    ├── __init__.py
    └── test_helpers.py

如果 'main.py' 尝试从 'helpers.py' 导入：

# Wrong way - will likely fail
from utils.helpers import my_function

# Right way - use absolute imports
from src.utils.helpers import my_function

修复：在每个目录中添加一个空的 '__init__.py' 文件并使用绝对导入：

# In src/main.py
from src.utils.helpers import my_function

# Or modify PYTHONPATH
import sys
import os
sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))

4. 软件包安装问题

有时 pip 安装会失败，无提示。下面是一个强大的安装检查：

def check_package_installation(package_name):
    try:
        __import__(package_name)
        return True
    except ImportError:
        return False
    
def install_if_missing(package_name):
    import subprocess
    import sys
    
    if not check_package_installation(package_name):
        print(f"Installing {package_name}...")
        subprocess.check_call([sys.executable, "-m", "pip", "install", package_name])
        return True
    return False

# Usage
install_if_missing("requests")