ModuleNotFoundError: No module named 'sklearn'
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
Trong bài này · 10
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 |
|---|---|---|
| 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 |
| gõ | cài |
| trong thư mục có file tự đặt tên | đổ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:
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ì:
python3 -c "import sklearn"
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:
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 TrueGó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:
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:
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 sklearnMộ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
Bạn đã chạy
pip install scikit-learnthành công, nhưngpython app.pyvẫn báoNo 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_learnthay choimport sklearn
Với
import importlib.util,importlib.util.find_spec("scikit-learn") is not Nonecho kết quả gì?TrueFalse- Báo lỗi
ModuleNotFoundError
Những việc nào sửa đúng lỗi khi cài một dự án cũ có dòng
sklearntrongrequirements.txt?- Thay dòng
sklearnbằngscikit-learn - Giữ nguyên
import sklearntrong code - Đổi mọi dòng
import sklearnthànhimport scikit_learn - Đổi dòng thành
sklearn==1.8.0
- Thay dòng
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.
def sua_requirements(dong):
pass # Viết thân hàm thay cho dòng nàyTó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-learnsau khi bật đúng môi trường; trong Jupyter dùng%pip install scikit-learn.Gói
sklearntrên PyPI đã bị chặn: thay bằngscikit-learntrong lệnh pip vàrequirements.txt.Tên import vẫn là
sklearn; một file tự đặt tênsklearn.pyche 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ủ đề
Bài này có hữu ích?
Hỏi đáp
Tham vấn chuyên môn
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.