10 solutions for Python error ModuleNotFoundError

1. Analysis of common error scenarios and causes

Scene Type	Typical error report example	root cause
Module not installed	`import requests`→ Report an error	Dependency isolation is caused by failure to install third-party libraries through pip/conda or virtual environment inactive
The path is not included	`import my_module`→ Report an error	The directory where the custom module is located is not added to, or the working directory and module path are inconsistent when running the script
Misspelled name	`import panda`(It should be`pandas`）	Case sensitive (e.g.`Config`and`config`), confusing built-in modules with third-party libraries
Dependency conflict	`import tensorflow`→ DLL loading failed	The underlying library that modules depend on is missing (such as the numpy version is too low), or the Python version is incompatible with the module
Package structure error	Custom package is missing`__init__.py`	Not marked as package (Python 3.3+ can be omitted, but it is recommended to keep it)

2. 10 solutions and code examples

1. Check and install missing modules

# Check the installed modulepip list | grep requests  # Linux/macOS
pip list | findstr requests  # Windows

# Install module (recommended to use Tsinghua Source Acceleration)pip install requests -i /simple

# Verify installationpython -c "import requests; print(requests.__version__)"

2. Dynamically add module paths

import os
import sys

# Method 1: Add the parent directory of the directory where the current script is locatedcurrent_dir = ((__file__))
parent_dir = (current_dir)
if parent_dir not in :
    (parent_dir)

# Method 2: Add absolute path directly('/path/to/your/module')

# Verify that the path is effectiveprint()  # Check whether the output contains the target path

3. Handle custom package structure issues

# Project structure example# my_project/
# ├── config/
# │ ├── __init__.py # Must exist, marked as a package# │   └── 
# ├── src/
# │   └── 

# Correctly import custom modules inimport sys
from pathlib import Path

# Add project root directory toproject_root = Path(__file__).()
if str(project_root) not in :
    (0, str(project_root))

from  import CONFIG_VALUE  # Correct import

4. Resolve dependency conflicts

# Generate dependency tree and check for conflictspipdeptree  # Need to install: pip install pipdeptree
# Sample output (conflict detected)# requests==2.28.1
# - certifi[required:&gt;=2017.4.17, installed:2023.7.22]
# - charset-normalizer[required:>=2,<4, installed:4.0.0] # Conflict!
# Solution: Lock the version or use the virtual environmentpip install "charset-normalizer&lt;4"

5. Fixed the problem of inactivating the virtual environment

# Check the current Python interpreter pathwhich python  # Linux/macOS
where python  # Windows

# Activate the virtual environment (taking venv as an example)source venv/bin/activate  # Linux/macOS
.\venv\Scripts\activate   # Windows

6. Clean the pip cache and try again

pip cache purge
pip install -r  --no-cache-dir

7. Upgrade the pip tool

pip install --upgrade pip

8. Dynamic capture import errors

try:
    import non_existent_module
except ModuleNotFoundError as e:
    print(f"Error details: {e}")
    print("Suggested Action:")
    print("1. Check if the module name is correct")
    print("2. Run `pip install non_existent_module` installation")
    print("3. Check if the module path is in ``")

9. Logging module loading process

import sys
import 

def log_module_load(module_name):
    spec = .find_spec(module_name)
    if spec is None:
        print(f"❌ Module{module_name}not found")
    else:
        print(f"✅ Module{module_name}path: {}")

log_module_load("os")  # Output example

10. Modify the PYTHONPATH environment variable

# Unix/Linux Systemexport PYTHONPATH="${PYTHONPATH}:/path/to/your/module"

# Windows system (via "System Properties" -> "Advanced" -> "Environment Variables")# or temporary settings (CMD)set PYTHONPATH=C:\path\to\your\module;%PYTHONPATH%

3. Advanced debugging skills

useimportlibDynamic import

import 

spec = .spec_from_file_location("", "/path/to/")
module = .module_from_spec(spec)
.exec_module(module)

passsys.meta_pathCustom import logicSuitable for complex scenarios (such as plug-in systems).

4. Summary

The core reasons for ModuleNotFoundError can be summarized as: module not installed, path not configured, name spelling errors, dependency conflicts. Through the 10 solutions provided in this article, combining code examples and toolchains (such as pipdeptree, importlib), developers can quickly locate and solve problems. For complex projects, it is recommended to use virtual environment + dependency lock files (such as Pipfile) to manage dependencies.

The above is the detailed content of 10 solutions for Python's error ModuleNotFoundError. For more information about Python's error ModuleNotFoundError, please follow my other related articles!