Download pandas và cài đặt: sửa lỗi No module named pandas

Để download pandas và cài vào máy, bạn mở cmd và chạy python -m pip install pandas, trong đó python phải là đúng bản Python sẽ chạy code của bạn. Lỗi ModuleNotFoundError: No module named 'pandas' gần như luôn có cùng một nguyên nhân: pandas đã được cài, nhưng vào một bản Python khác với bản đang chạy file.

Ngày 23/10/2026, mình tái hiện lỗi này trên một máy Windows 10 có sẵn Miniconda và cài thêm Python 3.15.1 từ python.org. Sau đó mình chạy cùng một file bao_cao.py ở 6 chỗ khác nhau. Kết quả:

• pip install pandas báo cài thành công sau 29,4 giây, nhưng lệnh py bao_cao.py ngay sau đó vẫn báo lỗi. Lý do là pip cài vào Python 3.14.6 của Miniconda, còn py chạy Python 3.15.1.

• VS Code, PyCharm, Jupyter notebook, môi trường conda và Thonny đều báo cùng một dòng lỗi, vì mỗi chỗ dùng một bản Python riêng.

• Cách sửa ở cả 6 chỗ theo cùng một nguyên tắc: tìm xem code chạy bằng file python.exe nào, rồi dùng chính file đó để cài.

Download pandas và cài bản mới nhất trên Windows thế nào?#

Theo trang pandas trên PyPI (kho package chính thức của Python), bản mới nhất ngày 23/10/2026 là pandas 3.1.0, đưa lên ngày 22/10/2026. Bản này cần Python 3.11 trở lên và có sẵn file cài cho Windows 64-bit từ Python 3.11 đến 3.15. Bạn không cần tải file thủ công: pip tự chọn đúng file cho bản Python của bạn.

Lệnh cài, gõ trong cmd:

python -m pip install pandas
python -c "import pandas; print(pandas.__version__)"

Lệnh thứ hai in 3.1.0 là xong. Trên máy mình, pip tải pandas cùng 4 package mà pandas cần:

Mình viết python -m pip thay cho pip vì cách này chắc chắn pip thuộc về đúng bản python mà bạn gọi. Lệnh pip đứng một mình có thể là pip của một bản Python khác, như phần dưới sẽ cho thấy.

Vì sao pip báo cài xong mà Python vẫn không thấy pandas?#

Mỗi bản Python trên máy có một thư mục site-packages riêng. Package cài vào bản này thì bản kia không thấy. Trên máy mình, lệnh where python liệt kê hai file python.exe: Miniconda đứng trước, Python 3.15 vừa cài đứng sau. Vì vậy gõ python thì ra 3.14.6, còn gõ py (Python Launcher của python.org) thì ra 3.15.1:

Lúc cài Python 3.15.1, mình có bật tùy chọn thêm vào PATH. Nhưng bộ cài cho riêng một người dùng ghi vào PATH của người dùng, mà Windows đọc PATH của máy (nơi Miniconda nằm) trước. Máy nào đã cài Anaconda hay Miniconda cho mọi người dùng, sau đó cài thêm Python cho riêng mình, cũng sẽ gặp đúng chuyện này.

Làm sao biết code đang chạy bằng Python nào?#

Hỏi thẳng Python bằng sys.executable, và hỏi pip xem nó thuộc bản nào. Trên máy mình:

C:\du-an>python -c "import sys; print(sys.executable)"
C:\ProgramData\miniconda3\python.exe

C:\du-an>py -c "import sys; print(sys.executable)"
C:\Users\Administrator\AppData\Local\Programs\Python\Python315\python.exe

C:\du-an>py -m pip --version
pip 26.2.2 from C:\Users\Administrator\AppData\Local\Programs\Python\Python315\Lib\site-packages\pip (python 3.15)

Muốn file chạy bằng py thấy pandas, mình cài bằng chính py:

py -m pip install pandas
py bao_cao.py

Lần này pandas 3.1.0 vào đúng thư mục Python315, và py bao_cao.py in ra bảng 3 tháng như mong đợi. Trong các phần mềm lập trình, cách làm cũng vậy: tìm đường dẫn python.exe mà phần mềm đang dùng, rồi cài pandas bằng đường dẫn đó.

Sửa lỗi No module named pandas theo từng chỗ chạy code#

Bảng dưới tóm tắt 6 chỗ mình chạy thử (riêng cmd có hai tình huống): mỗi chỗ dùng bản Python nào và cách sửa.

Trong VS Code: interpreter khác với Python ở cmd#

VS Code tự chọn .venv (môi trường ảo trong thư mục project) làm interpreter, tức bản Python dùng để chạy code. Thanh trạng thái ghi .venv (3.15.1). Môi trường này chưa có pandas, nên bấm chạy là lỗi, dù cmd bên ngoài đã cài pandas:

(.venv) PS C:\du-an> & c:\du-an\.venv\Scripts\python.exe c:/du-an/bao_cao.py
Traceback (most recent call last):
  File "c:\du-an\bao_cao.py", line 1, in <module>
    import pandas as pd
ModuleNotFoundError: No module named 'pandas'

Bấm vào chữ .venv (3.15.1) ở góc dưới để xem các bản Python mà VS Code tìm thấy. Trên máy mình có 3 lựa chọn: .venv của project, Python 3.15 cài từ python.org và base (môi trường gốc) của Miniconda.

Có hai cách sửa. Cách nhanh là chọn đúng bản đã có pandas (ở đây là base của Miniconda). Cách mình khuyên là giữ .venv và cài pandas vào chính nó: trong terminal của VS Code, khi đầu dòng có chữ (.venv), gõ python -m pip install pandas. Lúc thử, mình đưa pandas vào .venv bằng một cell %pip install pandas trong notebook chạy kernel .venv (cách ở mục Jupyter bên dưới). Lệnh trong terminal và cell %pip cài vào cùng một .venv. Sau khi .venv có pandas, chạy lại là ra kết quả:

Môi trường ảo .venv chưa được kích hoạt#

Nếu gõ pip install pandas trong cmd mà chưa kích hoạt .venv, pip vẫn chạy bình thường, chỉ là cài vào chỗ khác. Trên máy mình, pip báo pandas "đã có rồi" vì pip này thuộc Python của Miniconda, còn .venv thì vẫn trống:

C:\du-an>pip install pandas
Requirement already satisfied: pandas in C:\ProgramData\miniconda3\Lib\site-packages (3.1.0)

C:\du-an>.venv\Scripts\python bao_cao.py
Traceback (most recent call last):
  File "C:\du-an\bao_cao.py", line 1, in <module>
    import pandas as pd
ModuleNotFoundError: No module named 'pandas'

Cách sửa là kích hoạt .venv bằng .venv\Scripts\activate (cmd) hoặc .venv\Scripts\Activate.ps1 (PowerShell) trước khi cài, hoặc gọi thẳng .venv\Scripts\python -m pip install pandas. Trên PowerShell, script kích hoạt chỉ chạy khi execution policy cho phép. Máy mình để RemoteSigned nên chạy được, còn theo tài liệu của Microsoft, mặc định trên máy Windows dùng cá nhân là Restricted. VS Code tránh được chuyện này: mỗi khi mở terminal, nó tự chạy Set-ExecutionPolicy -Scope Process trước lệnh kích hoạt. Cách tạo, kích hoạt và xóa .venv trên cả Windows lẫn Ubuntu có ở bài môi trường ảo Python (venv).

Trong PyCharm: .venv mới tạo chưa có gì#

Lần đầu mở project, PyCharm 2026.2.3 báo chưa có interpreter. Mục Add Local Interpreter mặc định tạo .venv mới từ Python 3.15. Môi trường này trống, nên chạy bao_cao.py là lỗi. Ngay dưới dòng lỗi trong cửa sổ Run có nút Install Package. Bấm nút này thì PyCharm cài pandas vào .venv mà project đang dùng. Trên máy mình, .venv này cũng chính là .venv VS Code dùng ở mục trên, nên mình đưa pandas vào một lần bằng cell %pip.

Trong Jupyter notebook: kernel khác với terminal#

Mỗi notebook chạy code bằng một kernel, tức một bản Python đã đăng ký với Jupyter. Trường hợp này khó nhận ra nhất: terminal import pandas được, notebook thì không. Mình đăng ký .venv thành một kernel tên du-an-venv rồi chạy notebook bằng kernel đó:

Dòng print(sys.executable) trong cell cho thấy notebook đang chạy bằng C:\du-an\.venv\Scripts\python.exe, trong khi terminal chạy bằng Miniconda. Cách sửa chắc ăn là thêm một cell %pip ở đầu notebook. Lệnh %pip luôn cài vào đúng Python của kernel đang chạy:

%pip install pandas

Kết quả cell này khi mình chạy lại notebook (python-dateutil, tzdata và six đã vào .venv từ lúc mình đăng ký kernel, nên pip chỉ cài thêm numpy và pandas):

Successfully installed numpy-2.5.4 pandas-3.1.0
Note: you may need to restart the kernel to use updated packages.

Cell tiếp theo in C:\du-an\.venv\Scripts\python.exe và 3.1.0. Trong Jupyter Lab hay VS Code, nếu import pandas vẫn lỗi sau khi cài, bạn khởi động lại kernel như dòng nhắc ở trên.

Trong Miniconda: môi trường conda riêng#

Bản Windows trên máy ảo mình dùng có sẵn Miniconda 26.5.3. Khi tạo môi trường mới từ kênh mặc định (kênh là kho package mà conda tải về), conda dừng lại và báo mình chưa chấp nhận điều khoản dịch vụ của các kênh Anaconda. Mình chuyển sang kênh conda-forge, tạo môi trường phan-tich với Python 3.13, và gặp lại lỗi quen thuộc vì môi trường mới chưa có pandas:

Với môi trường conda, mình dùng conda install cho đúng môi trường đó (mất 37,9 giây):

conda install -n phan-tich -c conda-forge --override-channels pandas -y
conda run -n phan-tich python bao_cao.py

Trong Thonny: Thonny dùng Python riêng#

Thonny 5.0.0 có sẵn Python 3.14.4 bên trong, tách hẳn khỏi Python ở cmd. Mình mở bao_cao.py trong Thonny và bấm chạy. Ô Shell báo lỗi ngay, khung Trợ lý bên phải nhắc lại tên lỗi:

Cách sửa trong Thonny là vào Công cụ > Quản lý gói, gõ pandas vào ô tìm kiếm rồi bấm cài. Hộp thoại ghi rõ gói mới sẽ vào thư mục AppData\Roaming\Python\Python314\site-packages của Python trong Thonny:

Mình cài bằng lệnh tương đương trong cmd, gọi thẳng Python của Thonny:

"C:\Users\Administrator\AppData\Local\Programs\Thonny\python.exe" -m pip install --user pandas

Bấm chạy lại trong Thonny thì ra bảng 3 tháng.

Khi nào không nên dùng pip?#

Nếu bạn làm việc trong một môi trường conda, đừng trộn pip install vào môi trường đó khi conda có sẵn package. Hướng dẫn của conda khuyên cài bằng conda trước, chỉ dùng pip cho package conda không có. Lý do là pip không biết conda đã cài gì, nên dễ ghi đè numpy mà các package khác của conda đang dùng. Ngược lại, với Python cài từ python.org hay .venv, pip là cách chuẩn. Và đừng cài pandas vào base của Miniconda cho mọi project: mỗi project một .venv hoặc một môi trường conda riêng sẽ đỡ rối hơn nhiều khi máy có nhiều bản Python.

Câu hỏi thường gặp#

Pandas là thư viện gì?#

pandas là thư viện Python để đọc, lọc, gộp và tính toán dữ liệu dạng bảng (file Excel, CSV, bảng SQL). Kiểu dữ liệu chính là DataFrame: một bảng có tên cột và chỉ số dòng, giống một sheet Excel nhưng xử lý bằng code. Bài Python cho Excel có một ví dụ trọn vẹn: pandas đọc và gộp 12 file Excel bán hàng thành một báo cáo.

Download pandas ở đâu?#

Bạn không cần tải file pandas về tay. Lệnh python -m pip install pandas tự tải bản phù hợp từ PyPI. Mã nguồn và tài liệu chính thức nằm ở pandas.pydata.org.

pandas 3.1.0 cần Python bản nào?#

Python 3.11 trở lên. Nếu máy bạn còn Python 3.10 hoặc cũ hơn, pip sẽ cài bản pandas cũ hơn hợp với Python đó, hoặc báo không tìm thấy bản phù hợp.

Cài pandas có cần cài numpy trước không?#

Không cần. Khi cài pandas 3.1.0, pip tự cài numpy 2.5.4 kèm theo, cùng python-dateutil, tzdata và six. Vì sao pandas cần NumPy thì bài NumPy là gì giải thích bằng code chạy trên 6.000 đơn hàng mẫu.

Đã cài pandas mà VS Code vẫn gạch chân chữ pandas?#

Gạch chân là do Pylance (phần kiểm tra code của VS Code) đang dùng interpreter chưa có pandas. Chọn đúng interpreter ở góc dưới, hoặc thêm pandas vào interpreter đang chọn, thì gạch chân biến mất.

Đọc tiếp#

• Phần mềm lập trình Python: VS Code, PyCharm hay Thonny: số đo dung lượng, RAM và thời gian mở của ba phần mềm trên cùng máy Windows.

• Học Python từ số 0: lộ trình 8 chặng theo thứ tự, từ cài đặt đến project đầu tiên.

• Data Analyst cần học gì: pandas nằm ở đâu trong bộ kỹ năng phân tích dữ liệu.

Cài xong pandas, bạn có thể học tiếp với ebook Phân tích dữ liệu với Python của AIDev: sách viết cho pandas 3, có bài tập tự chấm để bạn kiểm tra ngay từng bước. Nếu chưa vững Python, hãy bắt đầu từ ebook Python từ số 0. Còn nếu bạn học pandas để đi làm AI, lộ trình AI Engineer từ số 0 đi từ Python, qua phân tích dữ liệu, đến machine learning.

Mình chạy ngày 23/10/2026 trên máy ảo AIDev Cloud: Windows 10 IoT Enterprise LTSC 21H2 (build 19044), Intel Xeon E5-2680 v4 8 luồng, 16 GB RAM. Phiên bản: pandas 3.1.0, numpy 2.5.4, Python 3.15.1 (python.org), Python 3.14.6 (Miniconda 26.5.3), Python 3.13 (conda-forge), Thonny 5.0.0 (Python 3.14.4), VS Code 1.143.0, PyCharm 2026.2.3.