Introduction

The error ImportError: No module named pandas (or ModuleNotFoundError: No module named 'pandas' in Python 3.6+) means Python cannot find the pandas library in its current environment. This is typically caused by pandas not being installed, being installed in a different Python environment, or a virtual environment not being activated.

Quick Fix

Install pandas in your current Python environment:

pip install pandas

Or with a specific Python version:

python3 -m pip install pandas

If the error persists after installation, the issue is almost certainly an environment mismatch.

Common Causes and Solutions

1. Pandas Not Installed

The most straightforward case — pandas has not been installed:

1# Check if pandas is installed
2pip show pandas
3
4# Install it
5pip install pandas

2. Wrong Python Environment

The most common cause of confusion. Pandas is installed in one Python installation, but you are running a different one:

1# Check which Python you are using
2which python
3which python3
4
5# Check which pip is being used
6which pip
7pip --version
8
9# Ensure pip matches your Python
10python3 -m pip install pandas

On systems with multiple Python versions (e.g., Python 3.8, 3.9, 3.10), pip might install to 3.8 while you run scripts with 3.10.

3. Virtual Environment Not Activated

If you installed pandas in a virtual environment, you must activate it:

1# venv
2source myenv/bin/activate    # Linux/macOS
3myenv\Scripts\activate       # Windows
4
5# Then install or verify
6pip install pandas

# conda
conda activate myenv
conda install pandas

4. Jupyter Notebook Using a Different Kernel

Jupyter may use a different Python kernel than your terminal:

# Check which Python Jupyter is using
import sys
print(sys.executable)

Install pandas for the specific kernel:

1# Install for the Jupyter kernel
2python -m pip install pandas
3
4# Or from within a Jupyter cell
5!pip install pandas

5. IDE Using a Different Interpreter

IDEs like VS Code, PyCharm, or Spyder have their own Python interpreter settings:

VS Code:

1. Open Command Palette (Ctrl+Shift+P)
2. Search "Python: Select Interpreter"
3. Choose the environment where pandas is installed

PyCharm:

1. Go to Settings > Project > Python Interpreter
2. Select the correct interpreter or add pandas via the "+" button

6. System Python vs User Python

On Linux/macOS, using sudo pip install installs to the system Python, while your user may run a different Python:

1# Install for your user only (recommended)
2pip install --user pandas
3
4# Or use the exact Python you want
5/usr/bin/python3.10 -m pip install pandas

Alternative Installation Methods

Using conda (Anaconda/Miniconda)

1conda install pandas
2
3# With a specific version
4conda install pandas=2.0.0

With specific version

pip install pandas==2.0.3

From requirements.txt

pip install -r requirements.txt

Where requirements.txt contains:

pandas>=2.0.0

Verifying the Installation

import pandas as pd
print(pd.__version__)  # e.g., "2.1.4"
print(pd.__file__)     # Shows where pandas is installed

Check the installation path matches your Python environment:

python -c "import pandas; print(pandas.__file__)"

Common Pitfalls

• Naming conflicts: Do not name your own script pandas.py — Python will import your file instead of the library. Also check for a pandas/ directory in your project.
• Mixing pip and conda: If you use Anaconda, prefer conda install pandas over pip install pandas. Mixing package managers can cause dependency conflicts.
• Permissions on shared servers: On shared servers without root access, use pip install --user pandas or create a virtual environment.
• Checking environment: Often overlooked, it is vital to ensure you are in the correct virtual environment or using the appropriate Python version for your project setup. Run which python and pip --version to confirm.
• Docker containers: Inside Docker, install pandas in the Dockerfile: RUN pip install pandas. Do not rely on system-level installations from the host.

Summary