Một số người dùng cố gắng cài đặt gói Python bằng Cửa sổ dòng lệnh báo cáo gặp lỗi "pip không được nhận dạng là lệnh nội bộ hoặc ngoại bộ". Hầu hết người dùng bị ảnh hưởng báo cáo vấn đề xảy ra ngay cả sau khi cài đặt bản phân phối Python và đảm bảo Python đã được thêm vào biến đường dẫn (PATH). Vấn đề không dành riêng cho một hệ điều hành cụ thể vì nó được báo cáo trên Windows 7, Windows 8 và Windows 10.
PIP là gì?
PiP là viết tắt đệ quy của "Pip Installs Packages". Đây về cơ bản là một hệ thống quản lý gói dùng để cài đặt và quản lý các gói phần mềm viết bằng Python. Hầu hết người dùng sử dụng PiP để cài đặt và quản lý các gói Python tìm thấy trong Python Package Index.
Các phiên bản Python mới nhất (Python 2.7.9 trở lên và Python 3.4) bao gồm Pip theo mặc định.
Nguyên nhân gây ra lỗi 'pip không được nhận dạng là lệnh nội bộ hoặc ngoại bộ'?
Chúng tôi đã điều tra vấn đề này bằng cách xem xét các báo cáo của người dùng và cố gắng tái hiện vấn đề trên máy tính của mình. Từ những gì thu thập được, có một số tình huống được biết đến kích hoạt thông báo lỗi cụ thể này:
- Cài đặt PIP không được thêm vào biến hệ thống – Để có thể chạy lệnh Python từ cửa sổ CMD, bạn cần thêm đường dẫn cài đặt PiP của mình vào PATH trong biến hệ thống. Nếu bạn cài Python bằng file thực thi cài đặt, nó nên được thêm tự động.
- Cài đặt bị thêm không đúng trong PATH của bạn – Dễ dàng làm sai PATH nếu bạn thêm nó thủ công. Khoảng trắng thừa hoặc thiếu dấu chấm phẩy trước PATH mới sẽ dẫn đến lỗi.
Nếu bạn đang cố gắng khắc phục thông báo lỗi cụ thể này ngăn cản bạn sử dụng lệnh Python trong CMD, hãy làm theo các phương pháp được quảng cáo trong bài viết này. Tất cả các sửa chữa tiềm năng dưới đây đều được xác nhận hoạt động bởi ít nhất một người dùng bị ảnh hưởng.
Để có kết quả tốt nhất, hãy làm theo các phương pháp dưới đây theo thứ tự cho đến khi tìm thấy sửa chữa giúp khắc phục vấn đề trong tình huống cụ thể của bạn.
Phương pháp 1: Kiểm tra xem PIP đã được thêm vào biến PATH chưa
Hãy bắt đầu bằng cách tìm hiểu tình hình hiện tại. Nếu bạn không biết cài đặt PIP của mình có được thêm vào biến PATH hay không, bạn có thể dễ dàng kiểm tra bằng cách sử dụng một lệnh nhất định tại dấu nhắc CMD.
Việc biết điều này sẽ chỉ cho bạn đúng hướng và giúp bạn tránh thử các bước không cần thiết.
Lưu ý: Nếu bạn đã biết đường dẫn cài đặt PIP của mình có trong biến PATH hay không, hãy chuyển xuống các phương pháp tiếp theo bên dưới.
Dưới đây là hướng dẫn nhanh kiểm tra xem cài đặt PIP đã có trong biến PATH chưa:
- Nhấn Windows + R để mở hộp thoại Run. Sau đó gõ "cmd" và nhấn Enter để mở Command Prompt.
- Trong cửa sổ command prompt, gõ echo %PATH% và nhấn Enter để lấy danh sách tất cả vị trí được thêm vào biến PATH.
- Nếu bạn tìm thấy đường dẫn tương tự như C:\Python37\Scripts (tùy thuộc vào phiên bản Python của bạn), nghĩa là đường dẫn cài đặt đã được thêm vào biến PATH. Trong trường hợp này, bạn có thể bỏ qua sang các phương pháp dưới đây và chuyển thẳng đến Phương pháp 4 nơi chúng tôi bắt đầu khắc phục sự cố liên quan đến đường dẫn cài đặt PiP.
Nếu bạn không tìm thấy đường dẫn cài đặt PiP bằng kiểm tra trên, hãy chuyển xuống các phương pháp tiếp theo (Phương pháp 2 và Phương pháp 3) để thêm PIP vào biến môi trường PATH.
Phương pháp 2: Thêm PIP vào biến môi trường PATH sử dụng giao diện Windows
Nếu Phương pháp 1 cho thấy cài đặt PIP không được đặt làm biến môi trường PATH và bạn đã cài đặt bản phân phối Python, bạn sẽ cần làm thủ công.
Sau khi hoàn thành quy trình dưới đây, bạn sẽ có thể nhập lệnh PiP từ cửa sổ Command Prompt. Dưới đây là hướng dẫn nhanh thêm cài đặt PiP vào biến môi trường Path sử dụng giao diện Windows:
- Nhấn Windows + R để mở hộp thoại Run. Sau đó gõ "sysdm.cpl" và nhấn Enter để mở màn hình System Properties.
- Trong màn hình System Properties, chuyển đến tab Advanced, sau đó nhấp vào Environment Variables.
- Trong màn hình Environment Variables, đi đến System variables và nhấp vào Path để chọn nó. Sau đó với Path được chọn, nhấp nút Edit....
- Trong màn hình Edit environment variable, nhấp vào New và thêm đường dẫn nơi cài đặt PiP nằm. Đối với Python 3.4, vị trí mặc định là C:\Python34\Scripts.
- Sau khi đường dẫn được thêm, mở cửa sổ CMD mới và thử cài đặt gói python đi kèm PiP. Bạn không nên còn thấy lỗi "pip không được nhận dạng là lệnh nội bộ hoặc ngoại bộ" nữa.
Nếu bạn đang tìm cách nhanh hơn để thêm vị trí PiP vào biến môi trường, hãy làm theo Phương pháp 3.
Phương pháp 3: Thêm PIP vào biến môi trường PATH sử dụng CMD
Một cách nhanh hơn để thiết lập biến môi trường đường dẫn PIP là làm trực tiếp từ cửa sổ CMD. Điều này sẽ tiết kiệm thời gian, nhưng có thể hơi khó khăn nếu bạn không quen dùng terminal.
Dưới đây là hướng dẫn nhanh thiết lập biến môi trường đường dẫn PiP trực tiếp từ cửa sổ Command Prompt:
- Nhấn Windows + R để mở hộp thoại Run. Sau đó gõ "cmd" và nhấn Enter để mở cửa sổ Command Prompt.
- Trong cửa sổ Command Prompt, chạy lệnh sau để đặt cài đặt PIP vào biến môi trường:
setx PATH “%PATH%;C:\Python37\Scripts”
Lưu ý: Hãy nhớ rằng trong lệnh này, chúng tôi sử dụng vị trí mặc định cho Python 3.7. Nếu bạn sử dụng phiên bản Python khác hoặc cài đặt ở vị trí tùy chỉnh, hãy thay đổi đường dẫn sau ';' cho phù hợp.
- Kiểm tra xem phương pháp này có thành công không bằng cách chạy gói cài đặt Python (sử dụng PIP) từ cùng cửa sổ CMD. Nếu bạn vẫn gặp thông báo lỗi, hãy chuyển xuống phương pháp tiếp theo bên dưới.
Phương pháp 4: Mở gói Python mà không cần thêm biến PiP
Nếu bạn đang tìm cách cài đặt gói Python từ CMD mà không thêm PiP vào biến môi trường PATH, bạn có thể sử dụng một vài lệnh khác nhau để cài đặt. Điều này cũng hoạt động nếu bạn đã dùng các phương pháp trên để cấu hình biến môi trường PATH nhưng vẫn gặp lỗi.
Dưới đây là một vài cách bạn có thể dùng để mở gói cài đặt Python trong CMD mà không cần thêm biến PIP:
Phương pháp ngắn:
- Nhấn Windows + R để mở hộp thoại Run. Sau đó gõ "cmd" và nhấn Enter để mở cửa sổ Command Prompt.
- Gõ lệnh sau và đảm bảo thay đổi phần giữ chỗ thành tên gói của bạn:
python -m pip install [packagename]
Lưu ý: Thay đổi [packagename] thành tên gói bạn đang cố gắng cài đặt.
Phương pháp dài:
- Mở hộp thoại Run bằng cách nhấn Windows + R. Sau đó gõ "cmd" và nhấn Enter để mở cửa sổ Command Prompt.
- Trong cửa sổ CMD, sử dụng lệnh sau để điều hướng đến thư mục chứa file .whl của python:
cd C:\python installs
Lưu ý: Trong ví dụ của chúng tôi, gói cài đặt Python nằm trong thư mục tên python installs. Hãy điều chỉnh lệnh này để điều hướng đến thư mục chứa file wheel.
- Tiếp theo, chạy lệnh sau để cài đặt gói Python sử dụng PiP:
c:\python37\scripts\pip.exe install [package].whl
Lưu ý: Hãy nhớ thay đổi vị trí cài đặt python của bạn nếu bạn dùng phiên bản cũ hơn hoặc cài ở vị trí tùy chỉnh. Ngoài ra, đảm bảo thay đổi phần giữ chỗ [package] thành tên gói của bạn.
Nếu hai phương pháp cuối này không cho phép bạn cài đặt gói Python từ cửa sổ CMD, hãy làm theo phương pháp cuối cùng bên dưới nơi chúng tôi đảm bảo PiP được cài đặt.
Phương pháp 5: Đảm bảo PiP được bao gồm trong cài đặt Python của bạn
Trước khi tiến hành cài đặt lại toàn bộ môi trường Python, hãy xem liệu PiP có bị bỏ qua khỏi cài đặt Python hay không. Một số trình cài đặt Python sẽ loại bỏ PiP khỏi cài đặt mặc định.
May mắn thay, bạn có thể khắc phục điều này bằng cách sửa đổi cài đặt Python và cấu hình nó để cài đặt PIP. Dưới đây là hướng dẫn nhanh cách làm điều này:
- Nhấn Windows + R để mở hộp thoại Run. Sau đó gõ "appwiz.cpl" và nhấn Enter để mở Programs and Features.
- Trong Programs and Features, nhấp chuột phải vào cài đặt Python và nhấp Change.
- Tại màn hình Modify Setup, nhấp vào Modify.
- Trong màn hình Optional Features, tích vào ô liên quan đến pip và nhấp Next.
- Nhấn nút Install để áp dụng thay đổi cho cài đặt Python.
- Sau khi cài đặt Python được sửa đổi, mở cửa sổ CMD và xem liệu bạn có thể cài đặt gói Python với PiP mà không thấy lỗi "pip không được nhận dạng là lệnh nội bộ hoặc ngoại bộ" hay không.
Phương pháp 6: Cài đặt Python qua trình cài đặt thực thi
Nếu bạn đã đi đến đây mà không có kết quả, cài đặt lại Python cùng các thành phần của nó có thể sẽ khắc phục lỗi "pip không được nhận dạng là lệnh nội bộ hoặc ngoại bộ".
Cách dễ nhất là sử dụng trình cài đặt thực thi Python. Nếu cấu hình đúng, nó sẽ tự động cài đặt PiP. Dưới đây là hướng dẫn nhanh cách làm điều này:
- Nhấn Windows + R để mở hộp thoại Run. Sau đó gõ "appwiz.cpl" và nhấn Enter để mở Programs and Features.
- Trong Programs and Features, cuộn xuống danh sách chương trình để tìm cài đặt Python. Khi tìm thấy, nhấp chuột phải vào nó và chọn Uninstall, sau đó làm theo hướng dẫn trên màn hình để xóa nó khỏi hệ thống. Sau khi bản phân phối Python bị xóa khỏi máy tính của bạn, hãy khởi động lại máy.
- Ở lần khởi động tiếp theo, truy cập liên kết này (tại đây) và tải xuống trình cài đặt thực thi Python mới nhất theo kiến trúc hệ điều hành của bạn.
- Mở file thực thi cài đặt và bắt đầu bằng cách đảm bảo ô liên quan đến Add Python to PATH được tích – Điều này đảm bảo bạn có thể chạy lệnh Python trong Command Prompt. Sau đó, nhấp vào Customize installation.
- Trong cửa sổ Optional Features, đảm bảo ô liên quan đến pip được tích, sau đó nhấp Next.
- Giữ nguyên vị trí mặc định và Advanced Options, sau đó nhấp Install để bắt đầu cài đặt.
- Sau khi cài đặt hoàn tất, hãy khởi động lại máy tính thủ công nếu bạn không được tự động nhắc làm vậy.
- Ở lần khởi động tiếp theo, xem liệu vấn đề đã được khắc phục bằng cách thử cài đặt gói Python qua cửa sổ CMD.
- Nếu bạn vẫn thấy lỗi "pip không được nhận dạng là lệnh nội bộ hoặc ngoại bộ", hãy gõ lệnh sau trong cửa sổ CMD:
python -m ensurepip --default-pip
Lưu ý: Với một số bản phân phối Python (đặc biệt là 3.6), có thể PiP không được cài đặt mặc định. Một trong những sửa chữa chính thức cho vấn đề này trong tài liệu là lệnh này.