Vấn đề: Một "bức tường" chữ đỏBạn chạy một lệnh pip install đơn giản và mong đợi nó hoàn thành trong vài giây. Thay vào đó, terminal của bạn bùng nổ với một loạt thông báo lỗi màu đỏ khi đang 'Building Wheel' cho các gói như mysqlclient, pandas, hoặc pycocotools. Ở dưới cùng, bạn sẽ thấy thủ phạm:
error: Microsoft Visual C++ 14.0 or greater is required. Get it with "Microsoft C++ Build Tools": https://visualstudio.microsoft.com/downloads/
Điều này thường xảy ra trên các bản cài đặt Windows mới. Nó đơn giản có nghĩa là hệ thống của bạn thiếu các công cụ để dịch mã C++ sang thứ mà máy tính của bạn thực sự có thể chạy được.
Tại sao Python cần các công cụ C++Không phải mọi thư viện Python đều được viết hoàn toàn bằng Python. Để đảm bảo tốc độ, nhiều thư viện hiệu suất cao sử dụng C hoặc C++ bên dưới. Khi bạn cài đặt chúng, pip sẽ cố gắng tìm một 'wheel'—một tệp đã được biên dịch sẵn và sẵn sàng để sử dụng.
Nếu không có sẵn bản wheel biên dịch sẵn cho phiên bản Python hoặc hệ điều hành cụ thể của bạn, pip sẽ cố gắng xây dựng thư viện từ đầu. Để làm được điều đó, nó cần trình biên dịch Microsoft Visual C++ (MSVC). Nếu không có nó, quá trình cài đặt sẽ thất bại vì máy tính của bạn không biết cách đọc mã nguồn của thư viện.
Kiểm tra nhanh: Nâng cấp Setup ToolsTrước khi bạn tải xuống hàng gigabyte phần mềm, hãy thử cập nhật các công cụ đóng gói cốt lõi. Các bản wheel hiện đại được thêm vào PyPI liên tục. Một phiên bản pip cũ có thể không nhìn thấy phiên bản biên dịch sẵn mà bạn cần.
python -m pip install --upgrade pip setuptools wheel
Hãy thử cài đặt lại sau khi chạy lệnh này. Nếu vẫn thất bại, bạn chắc chắn cần các công cụ biên dịch.
Cách khắc phục thực sự: Cài đặt Microsoft C++ Build ToolsBạn không cần toàn bộ Visual Studio IDE, vốn có thể chiếm tới 20GB dung lượng ổ cứng. Bạn chỉ cần các Build Tools độc lập. Bản tải xuống này nặng khoảng 1.5GB và sẽ chiếm khoảng 4.5GB trên ổ đĩa của bạn.
1. Tải bộ cài đặtTruy cập trang Microsoft C++ Build Tools. Nhấn vào Download Build Tools để tải tệp vs_buildtools.exe.
2. Chọn đúng các thành phầnĐây là phần quan trọng nhất. Chỉ chạy bộ cài đặt thôi là chưa đủ; bạn phải chỉ định cho nó biết cần cài đặt những gì.
- Mở Visual Studio Installer bạn vừa tải về.- Nhấn Install (hoặc Modify) trên thẻ Build Tools.- Trong tab Workloads, tích vào ô Desktop development with C++.- Ở phía bên phải, dưới mục Installation details, hãy xác nhận các mục sau đã được chọn:MSVC v143 - VS 2022 C++ x64/x86 build tools (Latest)- Windows 10 SDK (hoặc Windows 11 SDK nếu bạn đang dùng hệ điều hành mới nhất)### 3. Cài đặt và khởi động lạiNhấn nút Install. Khi quá trình đạt 100%, hãy khởi động lại máy tính. Windows cần lần khởi động lại này để nhận diện các đường dẫn trình biên dịch mới trong môi trường hệ thống.
Kiểm tra kết quảMở một terminal mới (Command Prompt hoặc PowerShell) và thử cài đặt lại. Ví dụ:
pip install mysqlclient
Bây giờ bạn sẽ thấy thông báo 'Building wheel for mysqlclient' theo sau là thông báo 'Successfully installed'. Các dòng chữ đỏ sẽ biến mất.
Giải quyết các vấn đề thường gặp### Vấn đề với 'cl.exe'Nếu lỗi vẫn tiếp diễn, pip có thể vẫn đang gặp khó khăn trong việc tìm trình biên dịch. Hãy tìm kiếm Developer Command Prompt for VS trong menu Start của bạn. Chạy lệnh pip install bên trong cửa sổ cụ thể đó. Môi trường này đã được cấu hình sẵn tất cả các đường dẫn cần thiết đến trình biên dịch C++.
Giải pháp thay thế bằng CondaNếu bạn đang sử dụng Anaconda hoặc Miniconda, bạn thường có thể bỏ qua rắc rối với C++. Conda sử dụng hệ sinh thái các bản build nhị phân riêng. Hãy thử lệnh này thay thế:
conda install -c conda-forge <tên-gói>