Bỏ qua đến nội dung chính
Mục lục

ModuleNotFoundError: No module named 'sklearn'

AIDev Team · duyệt: Nguyễn Việt Chung

Bài 1/18 · Chương 13

Giải nghĩa lỗi và cảnh báo

  • 6 phút
  • Cơ bản
  • Python 3.14
  • Cập nhật

Thông báo ModuleNotFoundError: No module named 'sklearn' nghĩa là trình thông dịch Python đang chạy code của bạn không tìm thấy thư viện scikit-learn, dù có thể bạn đã cài nó ở một chỗ khác. Lỗi này hay gặp ngay buổi đầu: cài xong trong một cửa sổ dòng lệnh, rồi chạy file bằng một Python khác, hoặc mở Jupyter với một kernel chưa có gói.

Cần biết trước: cài scikit-learn bằng pip.

Bảng tra nhanh: thông báo và cách sửa

Bảng dưới gom ba tình huống hay gặp quanh việc cài và import scikit-learn. Cột "Thông báo" là dòng cuối của lỗi:

Thông báo

Nguyên nhân

Cách sửa

No module named 'sklearn'

gói chưa vào trình thông dịch đang chạy (chưa bật venv, kernel Jupyter khác)

bật đúng môi trường rồi python -m pip install scikit-learn

The 'sklearn' PyPI package is deprecated

gõ pip install sklearn

cài scikit-learn, tên import vẫn là sklearn

No module named 'sklearn.linear_model'; 'sklearn' is not a package

trong thư mục có file tự đặt tên sklearn.py

đổi tên file đó

Trên trang này thư viện đã có sẵn, nên khối dưới tìm được sklearn nhưng không tìm được hai cách viết theo tên gói. Hàm find_spec() (hàm tìm module mà không import) trả None khi Python không thấy module:

python
import importlib.util

for ten in ["sklearn", "scikit_learn", "scikit-learn"]:
    print(ten, importlib.util.find_spec(ten) is not None)

KẾT QUẢ

sklearn True
scikit_learn False
scikit-learn False

Đổi "scikit_learn" thành "numpy" rồi chạy lại: dòng giữa in numpy True.

Bảng nguyên nhân chung của lỗi import cho mọi thư viện có ở bài ModuleNotFoundError; trang này chỉ nói phần riêng của scikit-learn.

Gói chưa vào đúng trình thông dịch

Mỗi môi trường ảo có thư mục thư viện riêng. Lệnh pip gõ trần có thể thuộc một Python khác với Python chạy file của bạn, nên gói vào một chỗ còn code tìm ở chỗ khác. Thử trên một Python sạch chưa cài gì:

bash
python3 -c "import sklearn"
text
ModuleNotFoundError: No module named 'sklearn'

Cách chắc chắn là gọi pip qua chính trình thông dịch sẽ chạy code: bật môi trường ảo, thấy (.venv) ở đầu dòng lệnh, rồi chạy python -m pip install scikit-learn. Trong Jupyter, chạy %pip install scikit-learn trong một ô để gói vào đúng kernel đang mở. Khi chưa chắc Python nào đang chạy, in sys.executable trong code và so với đường dẫn của venv.

ModuleNotFoundError là lớp con của ImportError, và thuộc tính name của lỗi cho biết tên module bị thiếu:

python
try:
    import sklearn_khong_co
except ModuleNotFoundError as loi:
    print(loi)
    print(loi.name, isinstance(loi, ImportError))

KẾT QUẢ

No module named 'sklearn_khong_co'
sklearn_khong_co True

Gói sklearn trên PyPI đã bị chặn

Tên sklearn trên PyPI từng là một gói rỗng chỉ kéo theo scikit-learn. Từ tháng 12/2023 gói đó cố ý dừng cài đặt, để ai còn gõ sai tên sửa lại. Chạy pip install sklearn, pip in một khối dài; phần giữa giải thích lý do:

text
The 'sklearn' PyPI package is deprecated, use 'scikit-learn'
rather than 'sklearn' for pip commands.

Sau khối đó pip báo không build được gói sklearn và dừng; câu chữ của dòng cuối đổi theo bản pip, nên trang không chép nó.

Cách sửa: cài scikit-learn, và thay tên sklearn bằng scikit-learn trong requirements.txt hay mọi file liệt kê gói của dự án. Tên trong code không đổi: vẫn import sklearn. Tên gói dùng cho pip cũng là tên mà importlib.metadata biết:

python
from importlib.metadata import version, PackageNotFoundError

print(version("scikit-learn"))
try:
    version("sklearn")
except PackageNotFoundError as loi:
    print(loi)

KẾT QUẢ

1.8.0
No package metadata was found for sklearn

Một dự án cũ ghi sklearn trong requirements.txt sẽ hỏng ở bước cài trên máy mới, dù vẫn chạy trên máy đã cài trước tháng 12/2023.

Kiểm tra nhanh

  1. Bạn đã chạy pip install scikit-learn thành công, nhưng python app.py vẫn báo No module named 'sklearn'. Nguyên nhân hay gặp nhất là gì?

    • scikit-learn không hỗ trợ Python bạn đang dùng
    • pip đã cài gói vào một trình thông dịch khác với trình thông dịch chạy app.py
    • Phải viết import scikit_learn thay cho import sklearn
  2. Với import importlib.util, importlib.util.find_spec("scikit-learn") is not None cho kết quả gì?

    • True
    • False
    • Báo lỗi ModuleNotFoundError
  3. Những việc nào sửa đúng lỗi khi cài một dự án cũ có dòng sklearn trong requirements.txt?

    • Thay dòng sklearn bằng scikit-learn
    • Giữ nguyên import sklearn trong code
    • Đổi mọi dòng import sklearn thành import scikit_learn
    • Đổi dòng thành sklearn==1.8.0
Đúng hết lần đầu +15 XP

Bài tập

Sửa tên gói sklearn trong requirements

dong là list các dòng của một file requirements.txt, mỗi dòng là tên một gói, có thể kèm điều kiện phiên bản bắt đầu bằng một trong các dấu =, <, >, !, ~ (như pandas>=3). Viết thân hàm sua_requirements(dong) trả về list mới cùng thứ tự. Dòng nào có tên gói đúng là sklearn (không phân biệt chữ hoa, bỏ khoảng trắng hai đầu) thì thay bằng đúng chuỗi "scikit-learn", bỏ luôn điều kiện phiên bản. Dòng khác giữ nguyên. Gói tên khác như sklearn-pandas không phải sklearn.

Ví dụ: ["numpy==2.4.6", "sklearn==0.0.post12"] cho ["numpy==2.4.6", "scikit-learn"]. Hàm không sửa list của nơi gọi.

Trả về: các dòng đã sửa, một list.

python
def sua_requirements(dong):
    pass  # Viết thân hàm thay cho dòng này

Tóm tắt

  • No module named 'sklearn' nghĩa là trình thông dịch đang chạy code chưa có scikit-learn, dù pip có thể đã cài vào Python khác.

  • Cài bằng python -m pip install scikit-learn sau khi bật đúng môi trường; trong Jupyter dùng %pip install scikit-learn.

  • Gói sklearn trên PyPI đã bị chặn: thay bằng scikit-learn trong lệnh pip và requirements.txt.

  • Tên import vẫn là sklearn; một file tự đặt tên sklearn.py che mất thư viện thật.

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

Đã cài scikit-learn mà Jupyter vẫn báo No module named sklearn?

Kernel của notebook là một trình thông dịch riêng, có thể khác Python trong dòng lệnh. Chạy %pip install scikit-learn trong một ô để cài vào đúng kernel, rồi khởi động lại kernel. Cách bật môi trường ảo trước khi mở Jupyter có ở bài venv.

Vì sao không còn pip install sklearn được nữa?

Gói sklearn chỉ là một tên giả kéo theo scikit-learn, và nhiều dự án ghi nhầm nó vào danh sách gói. Từ tháng 12/2023 gói đó cố ý báo lỗi khi cài, để bạn đổi sang scikit-learn. Lệnh đúng có ở bài cài scikit-learn.

Google Colab có cần cài scikit-learn không?

Không, Colab cài sẵn scikit-learn, nhưng có thể là một bản khác 1.8.0 của tutorial. In sklearn.__version__ để biết bản đang chạy; muốn đúng bản thì chạy %pip install scikit-learn==1.8.0 rồi khởi động lại phiên.

Chủ đề

modulenotfounderror no module named sklearn

Bài này có hữu ích?

Hỏi đáp

Đang tải câu hỏi…

Tham vấn chuyên môn

Nguyễn Việt Chung

Nhà sáng lập AIDev và VietPlatform · Thạc sĩ AI MSE

  • Tốt nghiệp thủ khoa xuất sắc Thạc sĩ AI MSE.
  • Đồng sáng lập, CTO E-University, SVOnline: số hóa 10+ đại học, 40.000+ sinh viên.
  • Xây hệ thống AI cho doanh nghiệp tại VietPlatform.
Biên soạn: AIDev Team · Rà soát · Quy trình biên tập