Skip to main content

How to Solve "ModuleNotFoundError: No module named 'pandas'" in Python

The ModuleNotFoundError: No module named 'pandas' error in Python means that you are trying to use the Pandas library, but Python can not find it. This usually happens when Pandas is not installed or is installed in a different Python environment than the one you're currently using.

This guide will help you to:

  • Install Pandas.
  • Troubleshoot common problems.
  • Set up your development environment (VS Code, PyCharm, Jupyter, Anaconda) correctly.

Installing Pandas (The Basic Solution)

The standard way to install Pandas is using pip, Python's package installer:

pip install pandas
  • Multiple Python Versions: If you have multiple Python versions, use pip3 (or a specific version like pip3.9):

    pip3 install pandas
  • Permissions Errors: If you see a permissions error (common on Linux/macOS), try:

    sudo pip3 install pandas  # Linux/macOS (Use with caution!)
    pip install pandas --user # Install just for your user

    Using a virtual environment is the BEST way to avoid permissions issues.

  • python -m pip: If pip isn't directly accessible, use:

    python -m pip install pandas  # Or python3 -m pip, py -m pip
  • Anaconda: If you're using Anaconda, the recommended command is:

    conda install -c anaconda pandas

Verifying the Installation

After installing, verify it works with a simple script:

import pandas as pd

print(pd.__version__) # Prints the Pandas version

# Example, create and print a DataFrame
df = pd.DataFrame({'A': [1, 2, 3], 'B': [4, 5, 6]})
print(df)

If this runs without a ModuleNotFoundError, Pandas is installed and importable. If you still get an error, continue to the troubleshooting steps.

Troubleshooting ModuleNotFoundError

Virtual Environments (Essential)

Always use virtual environments:

  1. Create: python3 -m venv venv (or python -m venv venv, py -m venv venv)
  2. Activate:
    • Linux/macOS: source venv/bin/activate
    • Windows (cmd): venv\Scripts\activate.bat
    • Windows (PowerShell): venv\Scripts\Activate.ps1
      • If you get a powershell error regarding running scripts, run: Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  3. Install: pip install pandas (inside the activated environment).

Your terminal prompt will change (e.g., (venv) $).

Multiple Python Versions:

  • Check: python --version (or python3 --version)
  • Correct pip: Use the pip (pip3, python -m pip) that corresponds to the Python version you are using.

IDE Configuration (VS Code, PyCharm)

Configure your IDE to use the correct interpreter/environment.

Jupyter Notebook

Install within a notebook cell:

!pip install pandas

Ensure your Jupyter kernel uses the right environment.

Naming Conflicts

Never name your files pandas.py.

Reinstalling pandas

pip uninstall pandas
pip install pandas

Installation Instructions for Specific Environments

Windows:

  • Open Command Prompt or PowerShell.
  • Use pip install pandas (or py -m pip install pandas).

macOS / Linux:

  • Open your Terminal
  • Use pip3 install pandas

Anaconda:

  • Use conda install -c anaconda pandas

Jupyter Notebook (within a cell):

!pip install pandas

Handling "Import 'pandas' could not be resolved" (Pylance - VS Code)

  • Check interpreter in VS Code.
  • Restart VS Code.
  • Ignore the warning if you are sure the package is installed: import pandas as pd # type: ignore

Conclusion

The ModuleNotFoundError: No module named 'pandas' error is usually a simple installation or environment issue.

  • Use virtual environments.
  • Install with the correct pip command.
  • Configure your IDE properly.

By following these steps, you can resolve this error and begin working with the powerful Pandas library.