Cách khắc phục trong 5 phút
Nếu bạn đang vội, đây là cách trực tiếp nhất để giải quyết vấn đề:
- Tải trình cài đặt Microsoft C++ Build Tools từ trang tải xuống chính thức.
- Chạy
vs_buildtools.exevà chọn workload "Desktop development with C++". - Kiểm tra thanh bên "Optional" ở bên phải. Xác nhận rằng MSVC v14x build tools và Windows 10 hoặc 11 SDK đã được chọn.
- Nhấp vào Install. Quá trình tải xuống khoảng 1.5 GB đến 2 GB, và sẽ chiếm khoảng 4.5 GB dung lượng ổ đĩa sau khi giải nén.
- Khởi động lại terminal (Command Prompt hoặc PowerShell) và thử chạy lại lệnh
pip installcủa bạn.
Tại sao lỗi này xảy ra?
Bạn thường thấy lỗi này vì pip đang cố gắng xây dựng (build) một thư viện từ mã nguồn. Hầu hết các gói Python được phân phối dưới dạng "Wheels" (.whl), là các tệp nhị phân đã được biên dịch sẵn để cài đặt ngay lập tức. Tuy nhiên, nếu không có wheel nào phù hợp với phiên bản Python hoặc kiến trúc Windows của bạn, pip sẽ quay lại sử dụng mã nguồn C++ gốc.
Các thư viện như numpy, pandas, lxml, và pycocotools sử dụng C++ để đạt tốc độ cao. Để chuyển mã đó thành một module Python hoạt động được, hệ thống của bạn cần một trình biên dịch (compiler). Windows không đi kèm sẵn trình biên dịch này. "Phiên bản 14.0" được đề cập trong lỗi ám chỉ Visual C++ 2015 runtime, mặc dù các phiên bản mới hơn (2017, 2019 và 2022) hoàn toàn tương thích ngược và hoạt động hoàn hảo.
Các giải pháp thay thế
Cách 1: Cập nhật các công cụ của bạn trước
Trước khi bắt đầu cài đặt hàng gigabyte dữ liệu, hãy kiểm tra xem các công cụ đóng gói của bạn có bị lỗi thời không. Các phiên bản pip mới hơn có khả năng tìm kiếm các wheel hiện có tốt hơn. Chạy lệnh sau để cập nhật mọi thứ:
python -m pip install --upgrade pip setuptools wheel
Thử cài đặt lại. Nếu phiên bản đã biên dịch sẵn tồn tại trên PyPI, pip sẽ lấy nó và bỏ qua hoàn toàn quá trình biên dịch phức tạp.
Cách 2: Sử dụng Conda cho Khoa học Dữ liệu
Nếu bạn đã mệt mỏi với các lỗi trình biên dịch, Anaconda hoặc Miniconda là một lựa chọn thay thế tuyệt vời. Không giống như pip thường biên dịch từ mã nguồn, hệ sinh thái Conda hầu như chỉ dựa vào các tệp nhị phân đã biên dịch sẵn. Bạn có thể cài đặt các gói phức tạp như scikit-learn hoặc twisted chỉ với một lệnh duy nhất:
conda install <package_name>
Cách 3: Tải xuống thủ công các Wheel đã biên dịch sẵn
Đôi khi bạn có thể bỏ qua quá trình build bằng cách tự tìm tệp wheel. Truy cập PyPI.org, tìm kiếm gói của bạn và kiểm tra phần "Download Files". Tìm tệp phù hợp với phiên bản Python của bạn (ví dụ: cp311 cho Python 3.11) và hệ điều hành của bạn (win_amd64). Tải tệp .whl về và cài đặt trực tiếp:
pip install C:\path\to\your_file.whl
Xác minh
Sau khi cài đặt Build Tools, hãy kiểm tra bản sửa lỗi với một gói nổi tiếng là yêu cầu trình biên dịch, chẳng hạn như twisted:
pip install twisted
Nếu thành công, kết quả sẽ như sau:
Successfully installed twisted-22.10.0
Mẹo chuyên nghiệp để xử lý sự cố
- Bắt buộc phải khởi động lại: Trình cài đặt sẽ sửa đổi PATH hệ thống của bạn. Terminal sẽ không nhận diện được trình biên dịch
cl.exemới cho đến khi bạn đóng và mở lại nó. - Kiểm tra phiên bản bit của Python: Việc kết hợp Python 32-bit với Build Tools 64-bit (hoặc ngược lại) có thể gây ra các lỗi liên kết khó hiểu. Hãy sử dụng Python 64-bit trừ khi bạn có lý do rất cụ thể để làm ngược lại.
- Dung lượng ổ đĩa: Bộ Visual Studio đầy đủ rất nặng. Nếu bạn chỉ cần trình biên dịch, hãy đảm bảo chỉ chọn workload "Desktop development with C++" để tiết kiệm khoảng 10 GB dung lượng.