pip là một chương trình dòng lệnh. Khi bạn cài đặt pip, một lệnh py -m pip install -r requirements.txt 8 sẽ được thêm vào hệ thống của bạn, lệnh này có thể được chạy từ dấu nhắc lệnh như sau
Unix/macOS
python -m pip <pip arguments>
py -m pip install -r requirements.txt 9 thực thi pip bằng trình thông dịch Python mà bạn đã chỉ định là python. Vì vậy, python -m pip freeze > requirements.txt python -m pip install -r requirements.txt 0 có nghĩa là bạn đang thực hiện pip cho thông dịch viên của bạn tại python -m pip freeze > requirements.txt python -m pip install -r requirements.txt 1
các cửa sổpy -m pip <pip arguments>
python -m pip freeze > requirements.txt python -m pip install -r requirements.txt 2 thực thi pip bằng trình thông dịch Python mới nhất mà bạn đã cài đặt. Để biết thêm chi tiết, hãy đọc tài liệu
Cài đặt gói
pip hỗ trợ cài đặt từ PyPI, kiểm soát phiên bản, dự án cục bộ và trực tiếp từ tệp phân phối
Kịch bản phổ biến nhất là cài đặt từ PyPI bằng cách sử dụng
Unix/macOS
python -m pip install SomePackage # latest version python -m pip install SomePackage==1.0.4 # specific version python -m pip install 'SomePackage>=1.0.4' # minimum version
các cửa sổ________số 8_______
Để biết thêm thông tin và ví dụ, xem tài liệu tham khảo
Thông tin xác thực cơ bản
Điều này hiện được đề cập trong Xác thực .
hỗ trợ mạng
Điều này hiện được đề cập trong Xác thực .
Hỗ trợ móc khóa
Điều này hiện được đề cập trong Xác thực .
Sử dụng máy chủ proxy
Khi cài đặt các gói từ PyPI, pip yêu cầu truy cập internet, trong nhiều môi trường công ty yêu cầu máy chủ proxy HTTP gửi đi
pip có thể được cấu hình để kết nối thông qua máy chủ proxy theo nhiều cách khác nhau
sử dụng tùy chọn dòng lệnh python -m pip freeze > requirements.txt python -m pip install -r requirements.txt 3 để chỉ định proxy ở dạng python -m pip freeze > requirements.txt python -m pip install -r requirements.txt 4
sử dụng python -m pip freeze > requirements.txt python -m pip install -r requirements.txt 5 trong một
bằng cách thiết lập các biến môi trường tiêu chuẩn python -m pip freeze > requirements.txt python -m pip install -r requirements.txt 6, python -m pip freeze > requirements.txt python -m pip install -r requirements.txt 7 và python -m pip freeze > requirements.txt python -m pip install -r requirements.txt 8
sử dụng biến môi trường python -m pip freeze > requirements.txt python -m pip install -r requirements.txt 9 để bao gồm một chuỗi được mã hóa JSON trong biến tác nhân người dùng được sử dụng trong các yêu cầu của pip
Tệp yêu cầu
“Tệp yêu cầu” là các tệp chứa danh sách các mục sẽ được cài đặt bằng cách sử dụng như vậy
Unix/macOS
python -m pip install -r requirements.txt
các cửa sổpy -m pip install -r requirements.txt
Chi tiết về định dạng của các tập tin có tại đây.
Về mặt logic, một tệp Yêu cầu chỉ là một danh sách các đối số được đặt trong một tệp. Lưu ý rằng bạn không nên dựa vào các mục trong tệp được cài đặt bởi pip theo bất kỳ thứ tự cụ thể nào
Trong thực tế, có 4 cách sử dụng tệp Yêu cầu phổ biến
Tệp yêu cầu được sử dụng để giữ kết quả nhằm mục đích đạt được Lượt cài đặt lặp lại . Trong trường hợp này, tệp yêu cầu của bạn chứa phiên bản được ghim của mọi thứ đã được cài đặt khi chạy py -m pip freeze > requirements.txt py -m pip install -r requirements.txt 0.
Unix/macOS
python -m pip freeze > requirements.txt python -m pip install -r requirements.txt
các cửa sổpy -m pip freeze > requirements.txt py -m pip install -r requirements.txt
Các tệp yêu cầu được sử dụng để buộc pip giải quyết đúng các phụ thuộc. điểm 20. 2 trở về trước không có độ phân giải phụ thuộc thực sự mà thay vào đó chỉ sử dụng thông số kỹ thuật đầu tiên mà nó tìm thấy cho một dự án. e. g. nếu py -m pip freeze > requirements.txt py -m pip install -r requirements.txt 1 yêu cầu py -m pip freeze > requirements.txt py -m pip install -r requirements.txt 2 và py -m pip freeze > requirements.txt py -m pip install -r requirements.txt 3 yêu cầu py -m pip freeze > requirements.txt py -m pip install -r requirements.txt 4 và nếu py -m pip freeze > requirements.txt py -m pip install -r requirements.txt 1 được giải quyết trước, pip sẽ chỉ sử dụng py -m pip freeze > requirements.txt py -m pip install -r requirements.txt 2 và có thể dễ dàng cài đặt phiên bản của py -m pip freeze > requirements.txt py -m pip install -r requirements.txt 7 mâu thuẫn với nhu cầu của py -m pip freeze > requirements.txt py -m pip install -r requirements.txt 3. Để giải quyết vấn đề này, bạn có thể đặt py -m pip freeze > requirements.txt py -m pip install -r requirements.txt 4 (i. e. thông số kỹ thuật chính xác) trực tiếp vào tệp yêu cầu của bạn cùng với các yêu cầu cấp cao nhất khác. như vậy
pkg1 pkg2 pkg3>=1.0,<=2.0
Các tệp yêu cầu được sử dụng để buộc pip cài đặt phiên bản thay thế của phụ thuộc phụ. Ví dụ: giả sử pkg1 pkg2 pkg3>=1.0,<=2.0 0 trong tệp yêu cầu của bạn yêu cầu pkg1 pkg2 pkg3>=1.0,<=2.0 1, nhưng phiên bản mới nhất (v1. 3) có lỗi, bạn có thể buộc pip chấp nhận các phiên bản cũ hơn như vậy
ProjectA ProjectB<1.3
Các tệp yêu cầu được sử dụng để ghi đè một phụ thuộc bằng một bản vá cục bộ nằm trong kiểm soát phiên bản. Ví dụ: giả sử một phụ thuộc pkg1 pkg2 pkg3>=1.0,<=2.0 2 từ PyPI có lỗi và bạn không thể đợi bản sửa lỗi ngược dòng. Bạn có thể sao chép/sao chép src, sửa lỗi và đặt nó vào VCS với thẻ pkg1 pkg2 pkg3>=1.0,<=2.0 3. Bạn sẽ tham khảo nó trong tệp yêu cầu của mình với một dòng như vậy
py -m pip <pip arguments> 0
Nếu pkg1 pkg2 pkg3>=1.0,<=2.0 2 trước đây là yêu cầu cấp cao nhất trong tệp yêu cầu của bạn, thì hãy thay thế dòng đó bằng dòng mới. Nếu pkg1 pkg2 pkg3>=1.0,<=2.0 2 là phụ thuộc phụ, thì thêm dòng mới
Điều quan trọng cần làm rõ là pip xác định các gói phụ thuộc bằng cách sử dụng siêu dữ liệu install_requires, chứ không phải bằng cách khám phá các tệp pkg1 pkg2 pkg3>=1.0,<=2.0 6 được nhúng trong các dự án
Xem thêm
"cài đặt. py so với yêu cầu. txt” (một bài báo của Donald Stufft)
Tập tin ràng buộc
Các tệp ràng buộc là các tệp yêu cầu chỉ kiểm soát phiên bản nào của yêu cầu được cài đặt chứ không phải phiên bản đó có được cài đặt hay không. Cú pháp và nội dung của chúng là một tập hợp con của , với một số loại cú pháp không được phép. các ràng buộc phải có tên, chúng không thể chỉnh sửa được và chúng không thể chỉ định các phần bổ sung. Về mặt ngữ nghĩa, có một điểm khác biệt chính. Bao gồm một gói trong tệp ràng buộc không kích hoạt cài đặt gói
Sử dụng một tệp ràng buộc như vậy
Unix/macOS
py -m pip <pip arguments> 1
các cửa sổpy -m pip <pip arguments> 2
Các tệp ràng buộc được sử dụng vì lý do chính xác giống như các tệp yêu cầu khi bạn không biết chính xác những thứ bạn muốn cài đặt. Chẳng hạn, giả sử rằng gói “helloworld” không hoạt động trong môi trường của bạn, vì vậy bạn có một phiên bản vá cục bộ. Một số thứ bạn cài đặt phụ thuộc vào “helloworld” và một số thì không
Một cách để đảm bảo rằng phiên bản đã vá được sử dụng một cách nhất quán là kiểm tra thủ công các phần phụ thuộc của mọi thứ bạn cài đặt và nếu có “helloworld”, hãy viết một tệp yêu cầu để sử dụng khi cài đặt thứ đó
Các tệp ràng buộc cung cấp một cách tốt hơn. viết một tệp ràng buộc duy nhất cho tổ chức của bạn và sử dụng tệp đó ở mọi nơi. Nếu thứ đang được cài đặt yêu cầu cài đặt “helloworld”, phiên bản cố định được chỉ định trong tệp ràng buộc của bạn sẽ được sử dụng
Hỗ trợ tệp ràng buộc đã được thêm vào trong pip 7. 1. Trong đó, chúng tôi đã thực hiện một cuộc đại tu khá toàn diện, loại bỏ một số yêu cầu không có giấy tờ và không được hỗ trợ khỏi quá trình triển khai trước đó, đồng thời loại bỏ các tệp ràng buộc thành một cách hoàn toàn để chỉ định giới hạn (phiên bản) toàn cầu cho các gói
Cài đặt từ bánh xe
“Wheel” là một định dạng lưu trữ được xây dựng có thể tăng tốc độ cài đặt rất nhiều so với việc xây dựng và cài đặt từ các kho lưu trữ nguồn. Để biết thêm thông tin, hãy xem Tài liệu bánh xe , PEP 427 và PEP 425
pip thích Bánh xe hơn nếu chúng có sẵn. Để tắt tính năng này, hãy sử dụng cờ cho
Nếu không tìm thấy bánh xe ưng ý, pip sẽ mặc định tìm kho lưu trữ nguồn
Để cài đặt trực tiếp từ kho lưu trữ bánh xe
Unix/macOS
py -m pip <pip arguments> 3
các cửa sổpy -m pip <pip arguments> 4
Để bao gồm các phụ thuộc tùy chọn được cung cấp trong siêu dữ liệu pkg1 pkg2 pkg3>=1.0,<=2.0 7 trong bánh xe, bạn phải thêm dấu ngoặc kép xung quanh tên mục tiêu cài đặt
Unix/macOS
py -m pip <pip arguments> 5
các cửa sổpy -m pip <pip arguments> 6
Ghi chú
Trong tương lai, cú pháp pkg1 pkg2 pkg3>=1.0,<=2.0 8 có thể không được dùng nữa. Nên sử dụng cú pháp PEP 508 bất cứ khi nào có thể
Đối với những trường hợp không có sẵn bánh xe, pip cung cấp sự tiện lợi, để tạo bánh xe cho tất cả các yêu cầu và phụ thuộc của bạn
yêu cầu phải cài đặt gói bánh xe, gói này cung cấp tiện ích mở rộng công cụ thiết lập “bdist_wheel” mà nó sử dụng
Để xây dựng các bánh xe cho các yêu cầu của bạn và tất cả các phụ thuộc của chúng vào một thư mục cục bộ
Unix/macOS
py -m pip <pip arguments> 7
các cửa sổpy -m pip <pip arguments> 8
Và sau đó để cài đặt các yêu cầu đó, chỉ cần sử dụng thư mục bánh xe cục bộ của bạn (chứ không phải từ PyPI)
Unix/macOS
py -m pip <pip arguments> 9
các cửa sổpython -m pip install SomePackage # latest version python -m pip install SomePackage==1.0.4 # specific version python -m pip install 'SomePackage>=1.0.4' # minimum version 0
Gỡ cài đặt gói
pip có thể gỡ cài đặt hầu hết các gói như vậy
Unix/macOS
python -m pip install SomePackage # latest version python -m pip install SomePackage==1.0.4 # specific version python -m pip install 'SomePackage>=1.0.4' # minimum version 1
các cửa sổpython -m pip install SomePackage # latest version python -m pip install SomePackage==1.0.4 # specific version python -m pip install 'SomePackage>=1.0.4' # minimum version 2
pip cũng thực hiện gỡ cài đặt tự động phiên bản cũ của gói trước khi nâng cấp lên phiên bản mới hơn
Để biết thêm thông tin và ví dụ, xem tài liệu tham khảo
Liệt kê các gói
Để liệt kê các gói đã cài đặt
Unix/macOS
python -m pip install SomePackage # latest version python -m pip install SomePackage==1.0.4 # specific version python -m pip install 'SomePackage>=1.0.4' # minimum version 3
các cửa sổpython -m pip install SomePackage # latest version python -m pip install SomePackage==1.0.4 # specific version python -m pip install 'SomePackage>=1.0.4' # minimum version 4
Để liệt kê các gói lỗi thời và hiển thị phiên bản mới nhất hiện có
Unix/macOS
python -m pip install SomePackage # latest version python -m pip install SomePackage==1.0.4 # specific version python -m pip install 'SomePackage>=1.0.4' # minimum version 5
các cửa sổpython -m pip install SomePackage # latest version python -m pip install SomePackage==1.0.4 # specific version python -m pip install 'SomePackage>=1.0.4' # minimum version 6
Để hiển thị chi tiết về gói đã cài đặt
Unix/macOS
python -m pip install SomePackage # latest version python -m pip install SomePackage==1.0.4 # specific version python -m pip install 'SomePackage>=1.0.4' # minimum version 7
các cửa sổpython -m pip install SomePackage # latest version python -m pip install SomePackage==1.0.4 # specific version python -m pip install 'SomePackage>=1.0.4' # minimum version 8
Để biết thêm thông tin và ví dụ, hãy xem và các trang tham khảo
Tìm kiếm các gói
pip có thể tìm kiếm PyPI cho các gói bằng cách sử dụng lệnh pkg1 pkg2 pkg3>=1.0,<=2.0 9
Unix/macOS
python -m pip install SomePackage # latest version python -m pip install SomePackage==1.0.4 # specific version python -m pip install 'SomePackage>=1.0.4' # minimum version 9
các cửa sổpy -m pip install SomePackage # latest version py -m pip install SomePackage==1.0.4 # specific version py -m pip install 'SomePackage>=1.0.4' # minimum version 0
Truy vấn sẽ được sử dụng để tìm kiếm tên và tóm tắt của tất cả các gói
Để biết thêm thông tin và ví dụ, xem tài liệu tham khảo
Cấu hình
Điều này hiện có trong Cấu hình .
Tập tin cấu hình
Điều này hiện có trong Cấu hình .
Biến môi trường
Điều này hiện có trong Cấu hình .
Ưu tiên cấu hình
Điều này hiện có trong Cấu hình .
Hoàn thành lệnh
pip hỗ trợ hoàn thành dòng lệnh trong bash, zsh và fish
Để thiết lập cho bash
py -m pip install SomePackage # latest version py -m pip install SomePackage==1.0.4 # specific version py -m pip install 'SomePackage>=1.0.4' # minimum version 1
Để thiết lập cho zsh
py -m pip install SomePackage # latest version py -m pip install SomePackage==1.0.4 # specific version py -m pip install 'SomePackage>=1.0.4' # minimum version 2
Để thiết lập cho cá
py -m pip install SomePackage # latest version py -m pip install SomePackage==1.0.4 # specific version py -m pip install 'SomePackage>=1.0.4' # minimum version 3
Để thiết lập cho powershell
py -m pip install SomePackage # latest version py -m pip install SomePackage==1.0.4 # specific version py -m pip install 'SomePackage>=1.0.4' # minimum version 4
Ngoài ra, bạn có thể sử dụng trực tiếp kết quả của lệnh ProjectA ProjectB<1.3 0 với hàm eval của shell, e. g. bằng cách thêm phần sau vào tệp khởi động của bạn
py -m pip install SomePackage # latest version py -m pip install SomePackage==1.0.4 # specific version py -m pip install 'SomePackage>=1.0.4' # minimum version 5
Cài đặt từ các gói cục bộ
Trong một số trường hợp, bạn có thể chỉ muốn cài đặt từ các gói cục bộ, không có lưu lượng truy cập đến PyPI
Trước tiên, hãy tải xuống các kho lưu trữ đáp ứng yêu cầu của bạn
Unix/macOS
py -m pip install SomePackage # latest version py -m pip install SomePackage==1.0.4 # specific version py -m pip install 'SomePackage>=1.0.4' # minimum version 6
các cửa sổpy -m pip install SomePackage # latest version py -m pip install SomePackage==1.0.4 # specific version py -m pip install 'SomePackage>=1.0.4' # minimum version 7
Lưu ý rằng ProjectA ProjectB<1.3 1 sẽ tìm trong bộ đệm bánh xe của bạn trước, trước khi thử tải xuống từ PyPI. Nếu bạn chưa bao giờ cài đặt các yêu cầu của mình trước đây, thì bạn sẽ không có bộ đệm bánh xe cho các mục đó. Trong trường hợp đó, nếu một số yêu cầu của bạn không có dạng bánh xe từ PyPI và bạn muốn có bánh xe, thì hãy chạy cái này để thay thế
Unix/macOS
py -m pip install SomePackage # latest version py -m pip install SomePackage==1.0.4 # specific version py -m pip install 'SomePackage>=1.0.4' # minimum version 8
các cửa sổpy -m pip install SomePackage # latest version py -m pip install SomePackage==1.0.4 # specific version py -m pip install 'SomePackage>=1.0.4' # minimum version 9
Sau đó, để chỉ cài đặt từ cục bộ, bạn sẽ sử dụng và như vậy
Unix/macOS
python -m pip install -r requirements.txt 0
các cửa sổpython -m pip install -r requirements.txt 1
Nâng cấp đệ quy “Chỉ khi cần thiết”
ProjectA ProjectB<1.3 2 hiện có tùy chọn ProjectA ProjectB<1.3 3 kiểm soát cách pip xử lý việc nâng cấp các phụ thuộc. Có 2 chiến lược nâng cấp được hỗ trợ
ProjectA ProjectB<1.3 4. nâng cấp tất cả các phụ thuộc bất kể chúng có đáp ứng các yêu cầu mới của cha mẹ hay không
ProjectA ProjectB<1.3 5. chỉ nâng cấp một phụ thuộc nếu nó không đáp ứng các yêu cầu mới của cha mẹ
Chiến lược mặc định là ProjectA ProjectB<1.3 5. Điều này đã được thay đổi trong pip 10. 0 do tính chất vi phạm của ProjectA ProjectB<1.3 4 khi nâng cấp các phụ thuộc xung đột
Điều quan trọng cần lưu ý là ProjectA ProjectB<1.3 8 ảnh hưởng đến các yêu cầu trực tiếp (e. g. những thứ được chỉ định trên dòng lệnh hoặc thông qua tệp yêu cầu) trong khi ProjectA ProjectB<1.3 3 ảnh hưởng đến các yêu cầu gián tiếp (sự phụ thuộc của các yêu cầu trực tiếp)
Ví dụ: giả sử py -m pip <pip arguments> 00 có phần phụ thuộc, pkg1 pkg2 pkg3>=1.0,<=2.0 2 và cả hai phần mềm này đều đã được cài đặt nhưng không phải là phiên bản mới nhất hiện có
py -m pip <pip arguments> 02. sẽ không nâng cấp py -m pip <pip arguments> 00 hoặc pkg1 pkg2 pkg3>=1.0,<=2.0 2 hiện có
py -m pip <pip arguments> 05. sẽ nâng cấp py -m pip <pip arguments> 00, nhưng không nâng cấp pkg1 pkg2 pkg3>=1.0,<=2.0 2 (trừ khi không đáp ứng yêu cầu tối thiểu)
py -m pip <pip arguments> 08. nâng cấp cả py -m pip <pip arguments> 00 và pkg1 pkg2 pkg3>=1.0,<=2.0 2
Như một ghi chú lịch sử, một "bản sửa lỗi" trước đó để có được hành vi ProjectA ProjectB<1.3 5 là
Unix/macOS
python -m pip install -r requirements.txt 2
các cửa sổpython -m pip install -r requirements.txt 3
Một đề xuất cho lệnh py -m pip <pip arguments> 12 đang được coi là một giải pháp thay thế an toàn hơn cho hành vi háo hức nâng cấp
Số lượt cài đặt của người dùng
Với Trăn 2. 6 đã xuất hiện, điều đó có nghĩa là tất cả các bản phân phối Python đều hỗ trợ vị trí cài đặt thay thế dành riêng cho người dùng. Vị trí mặc định cho mỗi hệ điều hành được giải thích trong tài liệu python cho biến. Có thể bật chế độ cài đặt này bằng cách chỉ định tùy chọn thành py -m pip <pip arguments> 13
Hơn nữa, “lược đồ người dùng” có thể được tùy chỉnh bằng cách đặt biến môi trường py -m pip <pip arguments> 14, biến này cập nhật giá trị của py -m pip <pip arguments> 15
Để cài đặt “SomePackage” vào môi trường có py -m pip <pip arguments> 15 được tùy chỉnh thành ‘/myappenv’, hãy làm như sau
Unix/macOS
python -m pip install -r requirements.txt 4
các cửa sổpython -m pip install -r requirements.txt 5
py -m pip <pip arguments> 17 tuân theo bốn quy tắc
Khi các gói được cài đặt trên toàn cầu nằm trên đường dẫn python và chúng xung đột với các yêu cầu cài đặt, chúng sẽ bị bỏ qua và không được gỡ cài đặt
Khi các gói được cài đặt toàn cầu nằm trên đường dẫn python và chúng đáp ứng các yêu cầu cài đặt, pip không làm gì cả và báo cáo rằng yêu cầu đó đã được đáp ứng (tương tự như cách các gói toàn cầu có thể đáp ứng các yêu cầu khi cài đặt các gói trong py -m pip <pip arguments> 18 virtualenv)
pip sẽ không thực hiện cài đặt py -m pip <pip arguments> 19 trong py -m pip <pip arguments> 20 virtualenv (i. e. loại virtualenv mặc định), do trang web của người dùng không nằm trên đường dẫn python. Việc cài đặt sẽ là vô nghĩa
Trong virtualenv py -m pip <pip arguments> 18, pip sẽ không cài đặt gói xung đột với gói trong gói trang web virtualenv. Cài đặt --user sẽ thiếu sys. ưu tiên đường dẫn và vô nghĩa
Để làm cho các quy tắc rõ ràng hơn, đây là một số ví dụ
Từ bên trong một py -m pip <pip arguments> 20 virtualenv (i. e. loại mặc định)
Unix/macOS
python -m pip install -r requirements.txt 6
các cửa sổpython -m pip install -r requirements.txt 7
Từ bên trong một py -m pip <pip arguments> 18 virtualenv trong đó py -m pip <pip arguments> 24 đã được cài đặt trong virtualenv
Unix/macOS
python -m pip install -r requirements.txt 8
các cửa sổpython -m pip install -r requirements.txt 9
Từ bên trong một con trăn thực, nơi mà py -m pip <pip arguments> 00 không được cài đặt trên toàn cầu
Unix/macOS
py -m pip install -r requirements.txt 0
các cửa sổpy -m pip install -r requirements.txt 1
Từ bên trong một con trăn thực, trong đó py -m pip <pip arguments> 00 được cài đặt trên toàn cầu, nhưng không phải là phiên bản mới nhất
Unix/macOS
py -m pip install -r requirements.txt 2
các cửa sổpy -m pip install -r requirements.txt 3
Từ bên trong một con trăn thực, nơi mà py -m pip <pip arguments> 00 được cài đặt trên toàn cầu và là phiên bản mới nhất
Unix/macOS
py -m pip install -r requirements.txt 4
các cửa sổpy -m pip install -r requirements.txt 5
Đảm bảo khả năng lặp lại
Điều này hiện được đề cập trong Lượt cài đặt lặp lại .
Sửa chữa các phụ thuộc xung đột
Điều này hiện được đề cập trong Giải pháp phụ thuộc .
Sử dụng pip từ chương trình của bạn
Như đã lưu ý trước đây, pip là một chương trình dòng lệnh. Mặc dù nó được triển khai bằng Python và do đó có sẵn từ mã Python của bạn qua py -m pip <pip arguments> 28, nhưng bạn không được sử dụng các API nội bộ của pip theo cách này. Có một số lý do cho việc này
Mã pip giả định rằng nó nằm trong quyền kiểm soát duy nhất đối với trạng thái chung của chương trình. pip quản lý những thứ như cấu hình hệ thống ghi nhật ký hoặc giá trị của luồng IO tiêu chuẩn mà không xem xét khả năng mã người dùng có thể bị ảnh hưởng
mã của pip không phải là luồng an toàn. Nếu bạn chạy pip trong một luồng, không có gì đảm bảo rằng mã của bạn hoặc của pip sẽ hoạt động như bạn mong đợi
pip giả định rằng sau khi hoàn thành công việc, quá trình sẽ kết thúc. Không cần xử lý khả năng mã khác sẽ tiếp tục chạy sau thời điểm đó, vì vậy (ví dụ) gọi pip hai lần trong cùng một quy trình có khả năng xảy ra sự cố
Điều này không có nghĩa là về nguyên tắc, các nhà phát triển pip phản đối ý tưởng rằng pip có thể được sử dụng làm thư viện - chỉ là đây không phải là cách nó được viết và sẽ cần rất nhiều công việc để thiết kế lại phần bên trong để sử dụng . Và đơn giản là chúng tôi hiện không có đủ nguồn lực để xem xét một nhiệm vụ như vậy
Điều này có nghĩa là trong thực tế, mọi thứ bên trong pip được coi là chi tiết triển khai. Ngay cả tên nhập khẩu là py -m pip install -r requirements.txt 8 cũng có thể thay đổi mà không cần báo trước. Mặc dù chúng tôi cố gắng không làm hỏng mọi thứ nhiều nhất có thể, nhưng tất cả các API nội bộ có thể thay đổi bất cứ lúc nào, vì bất kỳ lý do gì. Điều đó cũng có nghĩa là chúng tôi thường không khắc phục các sự cố do sử dụng pip theo cách không được hỗ trợ
Cũng cần lưu ý rằng việc cài đặt các gói vào py -m pip <pip arguments> 30 trong quy trình Python đang chạy là điều chỉ nên được thực hiện cẩn thận. Hệ thống nhập lưu trữ một số dữ liệu nhất định và việc cài đặt các gói mới trong khi chương trình đang chạy có thể không phải lúc nào cũng hoạt động như mong đợi. Trong thực tế, hiếm khi có vấn đề xảy ra, nhưng đó là điều cần lưu ý
Đã nói tất cả những điều trên, bạn nên bao gồm các tùy chọn có sẵn nếu bạn quyết định rằng bạn muốn chạy pip từ bên trong chương trình của mình. Cách tiếp cận đáng tin cậy nhất và được hỗ trợ đầy đủ là chạy pip trong quy trình con. Điều này được thực hiện dễ dàng bằng cách sử dụng mô-đun py -m pip <pip arguments> 31 tiêu chuẩn
py -m pip install -r requirements.txt 6
Nếu bạn muốn xử lý thêm đầu ra, hãy sử dụng một trong các API khác trong mô-đun. Chúng tôi đang sử dụng đóng băng ở đây để xuất các gói đã cài đặt ở định dạng yêu cầu
py -m pip install -r requirements.txt 7
Nếu bạn không muốn sử dụng chức năng dòng lệnh của pip mà muốn triển khai mã hoạt động với các gói Python, siêu dữ liệu của chúng hoặc PyPI, thì bạn nên xem xét các gói khác, được hỗ trợ, cung cấp loại khả năng này. Một số ví dụ mà bạn có thể xem xét bao gồm
py -m pip <pip arguments> 32 - Các tiện ích để hoạt động với siêu dữ liệu gói tiêu chuẩn (phiên bản, yêu cầu, v.v. )
py -m pip <pip arguments> 33 (cụ thể là py -m pip <pip arguments> 34) - Chức năng truy vấn gói mà người dùng đã cài đặt trên hệ thống của họ
py -m pip <pip arguments> 35 - Tiện ích đóng gói và phân phối (bao gồm các chức năng tương tác với PyPI)
Các thay đổi đối với trình phân giải phụ thuộc pip trong 20. 3 (2020)
điểm 20. 3 có trình phân giải phụ thuộc mới, được bật theo mặc định cho người dùng Python 3. (pip 20. 1 và 20. Đã bao gồm 2 phiên bản phát hành trước của trình phân giải phụ thuộc mới, ẩn sau các cờ người dùng tùy chọn. ) Đọc bên dưới để biết hướng dẫn di chuyển, cách gọi trình phân giải kế thừa và tiến trình ngừng sử dụng. Chúng tôi cũng đã thực hiện một video giải thích dài hai phút mà bạn có thể xem
Chúng tôi sẽ tiếp tục cải thiện trình giải quyết phụ thuộc pip để đáp lại phản hồi của người thử nghiệm. Vui lòng gửi phản hồi cho chúng tôi thông qua khảo sát kiểm tra trình giải quyết
Coi chừng
Thay đổi lớn trong bản phát hành này là trình phân giải phụ thuộc pip trong pip
Máy tính cần biết thứ tự phù hợp để cài đặt các phần mềm (“để cài đặt py -m pip <pip arguments> 36, bạn cần cài đặt py -m pip <pip arguments> 37 trước”). Vì vậy, khi các lập trình viên Python chia sẻ phần mềm dưới dạng các gói, họ phải mô tả chính xác các điều kiện tiên quyết cài đặt đó và pip cần điều hướng các tình huống khó khăn khi nhận được các hướng dẫn xung đột. Trình giải quyết phụ thuộc mới này sẽ giúp pip xử lý logic phức tạp đó tốt hơn, đồng thời giúp bạn sử dụng và khắc phục sự cố pip dễ dàng hơn
Những thay đổi quan trọng nhất đối với trình giải quyết là
Nó sẽ làm giảm sự không nhất quán. nó sẽ không còn cài đặt tổ hợp các gói không nhất quán lẫn nhau. Trong các phiên bản cũ hơn của pip, pip có thể cài đặt gói không đáp ứng các yêu cầu đã khai báo của gói đã cài đặt khác. Ví dụ, trong pip 20. 0, py -m pip <pip arguments> 38 làm sai, cài đặt “thành công” py -m pip <pip arguments> 39, mặc dù py -m pip <pip arguments> 40 yêu cầu py -m pip <pip arguments> 41 (). Thay vào đó, trình phân giải mới hoàn toàn từ chối cài đặt bất cứ thứ gì nếu nó nhận được đầu vào đó
Nó sẽ nghiêm ngặt hơn - nếu bạn yêu cầu pip cài đặt hai gói có yêu cầu không tương thích, nó sẽ từ chối (chứ không phải cài đặt một kết hợp bị hỏng, giống như trong các phiên bản trước)
Vì vậy, nếu bạn đang sử dụng các giải pháp thay thế để buộc pip xử lý các kết hợp yêu cầu không tương thích hoặc không nhất quán, thì bây giờ là thời điểm tốt để khắc phục sự cố cơ bản trong các gói, vì pip sẽ nghiêm ngặt hơn từ đây trở đi
Điều này cũng có nghĩa là, khi bạn chạy lệnh py -m pip <pip arguments> 13, pip chỉ xem xét các gói bạn đang cài đặt trong lệnh đó và có thể phá vỡ các gói đã cài đặt. Nó sẽ không đảm bảo rằng môi trường của bạn sẽ luôn nhất quán. Nếu bạn py -m pip <pip arguments> 43 và sau đó là py -m pip <pip arguments> 44, có thể phiên bản của py -m pip <pip arguments> 37 mà bạn nhận được sẽ khác so với phiên bản bạn đã chạy py -m pip <pip arguments> 46 trong một lệnh. Chúng tôi đang xem xét thay đổi hành vi này (theo #7744) và muốn biết suy nghĩ của bạn về hành vi của pip;
Chúng tôi cũng đang thay đổi hỗ trợ của mình đối với , lượt cài đặt có thể chỉnh sửa và chức năng liên quan. Chúng tôi đã thực hiện một cuộc đại tu khá toàn diện và loại bỏ các tệp ràng buộc thành một cách hoàn toàn để chỉ định giới hạn (phiên bản) toàn cầu cho các gói và do đó, một số kết hợp từng được cho phép giờ đây sẽ gây ra lỗi. Đặc biệt
Các ràng buộc không ghi đè các yêu cầu hiện có;
Việc cung cấp một yêu cầu có thể chỉnh sửa (py -m pip <pip arguments> 47) không khiến pip bỏ qua các giới hạn hoặc giới hạn phiên bản (xem #8076) và nếu bạn có xung đột giữa một yêu cầu được ghim và một thư mục cục bộ thì pip sẽ cho biết rằng nó không thể tìm thấy một phiên bản thỏa mãn cả hai (
Chế độ kiểm tra hàm băm yêu cầu tất cả các yêu cầu được chỉ định là phù hợp với py -m pip <pip arguments> 48 trên một phiên bản và có thể không hoạt động tốt khi kết hợp với các ràng buộc (xem #9020 và #8792)
Nếu cần thiết để đáp ứng các ràng buộc, pip sẽ vui vẻ cài đặt lại các gói, nâng cấp hoặc hạ cấp mà không cần bất kỳ tùy chọn dòng lệnh bổ sung nào (xem #8115 và Các tùy chọn kiểm soát quá trình cài đặt= v2. 7. 9 hoặc Python 3 >= v3.