Trước khi tiếp tục, hãy đảm bảo rằng bạn có Python và phiên bản dự kiến có sẵn từ dòng lệnh của bạn. Bạn có thể kiểm tra điều này bằng cách chạy
Unix/macOS
python3 --versioncác cửa sổ
py --version
Bạn sẽ nhận được một số đầu ra như
py -m pip --version0. Nếu bạn chưa có Python, vui lòng cài đặt 3 phiên bản mới nhất. phiên bản x từ python. org hoặc tham khảo phần Cài đặt Python trong Hướng dẫn về Python của Người đi nhờ xe.
Ghi chú
Nếu bạn là người mới và bạn gặp lỗi như thế này
>>> python --version Traceback [most recent call last]: File "", line 1, in NameError: name 'python' is not defined
Đó là bởi vì lệnh này và các lệnh được đề xuất khác trong hướng dẫn này nhằm mục đích chạy trong trình bao [còn được gọi là thiết bị đầu cuối hoặc bảng điều khiển]. Xem hướng dẫn bắt đầu sử dụng Python dành cho người mới bắt đầu để biết phần giới thiệu về cách sử dụng trình bao của hệ điều hành và tương tác với Python
Ghi chú
Nếu bạn đang sử dụng trình bao nâng cao như IPython hoặc sổ ghi chép Jupyter, bạn có thể chạy các lệnh hệ thống giống như các lệnh trong hướng dẫn này bằng cách đặt trước chúng bằng ký tự
py -m pip --version1
In [1]: import sys !{sys.executable} --version Python 3.6.3
Bạn nên viết
py -m pip --version2 thay vì
py -m pip --version3 đơn giản để đảm bảo rằng các lệnh được chạy trong bản cài đặt Python phù hợp với sổ ghi chép hiện đang chạy [có thể không giống với bản cài đặt Python mà lệnh
py -m pip --version3 đề cập đến]
Ghi chú
Do cách mà hầu hết các bản phân phối Linux đang xử lý quá trình di chuyển Python 3, người dùng Linux sử dụng hệ thống Python mà không tạo môi trường ảo trước tiên nên thay thế lệnh
py -m pip --version3 trong hướng dẫn này bằng
py -m pip --version6 và lệnh
py -m pip --version7 bằng
py -m pip --version8. Không chạy bất kỳ lệnh nào trong hướng dẫn này với
py -m pip --version9. nếu bạn gặp lỗi về quyền, hãy quay lại phần tạo môi trường ảo, thiết lập một môi trường rồi tiếp tục với hướng dẫn như đã viết
Đảm bảo bạn có thể chạy pip từ dòng lệnh¶
Ngoài ra, bạn cần đảm bảo rằng bạn có sẵn pip . Bạn có thể kiểm tra điều này bằng cách chạy.
Unix/macOS
py --version4các cửa sổ
py -m pip --version
Nếu bạn đã cài đặt Python từ nguồn, với trình cài đặt từ python. org hoặc qua Homebrew, bạn đã có pip. Nếu bạn đang sử dụng Linux và được cài đặt bằng trình quản lý gói hệ điều hành, bạn có thể phải cài đặt pip riêng, xem Cài đặt pip/setuptools/wheel với Trình quản lý gói Linux.
Nếu
py --version60 chưa được cài đặt, thì trước tiên hãy thử khởi động nó từ thư viện chuẩn
Unix/macOS
py --version6các cửa sổ
py --version8
Nếu điều đó vẫn không cho phép bạn chạy
py -m pip --version7
Tải xuống an toàn get-pip. py 1
Chạy
py --version62. 2 Điều này sẽ cài đặt hoặc nâng cấp pip. Ngoài ra, nó sẽ cài đặt công cụ thiết lập và bánh xe nếu chúng chưa được cài đặt .Cảnh báo
Hãy thận trọng nếu bạn đang sử dụng bản cài đặt Python do hệ điều hành của bạn hoặc trình quản lý gói khác quản lý. get-pip. py không phối hợp với các công cụ đó và có thể khiến hệ thống của bạn ở trạng thái không nhất quán. Bạn có thể sử dụng
py --version63 để cài đặt trongpy --version64 được thiết kế cho phần mềm cài đặt cục bộ
Đảm bảo pip, setuptools và bánh xe được cập nhật¶
Mặc dù chỉ riêng
py --version60 là đủ để cài đặt từ kho lưu trữ nhị phân dựng sẵn, các bản sao cập nhật của dự án
py --version66 và
py --version67 rất hữu ích để đảm bảo bạn cũng có thể cài đặt từ kho lưu trữ nguồn
Unix/macOS
py -m pip --version6các cửa sổ
py -m pip --version7
Tùy chọn, tạo một môi trường ảo¶
Xem phần bên dưới để biết chi tiết, nhưng đây là venv 3 command to use on a typical Linux system:
Unix/macOS
py --version0các cửa sổ
py --version1
Thao tác này sẽ tạo một môi trường ảo mới trong thư mục con
py --version68 và định cấu hình shell hiện tại để sử dụng nó làm môi trường
py -m pip --version3 mặc định
Tạo môi trường ảo¶
"Môi trường ảo" Python cho phép gói Python được cài đặt ở một vị trí biệt lập cho một ứng dụng cụ thể, thay vì được cài đặt trên toàn cầu. Nếu bạn đang muốn cài đặt các công cụ dòng lệnh chung một cách an toàn, hãy xem Cài đặt các công cụ dòng lệnh độc lập .
Hãy tưởng tượng bạn có một ứng dụng cần phiên bản 1 của LibFoo, nhưng một ứng dụng khác yêu cầu phiên bản 2. Làm thế nào bạn có thể sử dụng cả hai ứng dụng này? . 6/site-gói [hoặc bất kể vị trí tiêu chuẩn của nền tảng của bạn là gì], rất dễ dẫn đến tình trạng bạn vô tình nâng cấp một ứng dụng không nên nâng cấp
Hay tổng quát hơn, nếu bạn muốn cài đặt một ứng dụng và để yên thì sao?
Ngoài ra, nếu bạn không thể cài đặt gói vào thư mục gói trang web toàn cầu thì sao? .
Trong tất cả các trường hợp này, môi trường ảo có thể giúp bạn. Họ có thư mục cài đặt riêng và họ không chia sẻ thư viện với các môi trường ảo khác
Hiện tại, có 2 công cụ phổ biến để tạo môi trường ảo Python
venv có sẵn theo mặc định trong Python 3. 3 trở lên và cài đặt pip và công cụ thiết lập vào môi trường ảo đã tạo trong . 4 trở lên.
virtualenv cần được cài đặt riêng nhưng hỗ trợ Python 2. 7+ và Python3. 3+ và pip , công cụ thiết lập và wheel are always installed into created virtual environments by default [regardless of Python version].
Cách sử dụng cơ bản là như vậy
Sử dụng venv .
Unix/macOS
py --version2các cửa sổ
py --version3
Sử dụng virtualenv .
Unix/macOS
py --version4các cửa sổ
py --version5
Để biết thêm thông tin, hãy xem tài liệu venv hoặc virtualenv docs.
Việc sử dụng nguồn trong hệ vỏ Unix đảm bảo rằng các biến của môi trường ảo được đặt trong hệ vỏ hiện tại chứ không phải trong quy trình con [sau đó biến mất, không có tác dụng hữu ích]
Trong cả hai trường hợp trên, người dùng Windows nên _không_ sử dụng lệnh nguồn mà nên chạy tập lệnh kích hoạt trực tiếp từ trình bao lệnh như vậy
py --version6
Quản lý trực tiếp nhiều môi trường ảo có thể trở nên tẻ nhạt, vì vậy hướng dẫn quản lý phụ thuộc giới thiệu một công cụ cấp cao hơn, Pipenv, that automatically manages a separate virtual environment for each project and application that you work on.
Sử dụng pip để cài đặt¶
pip là trình cài đặt được đề xuất. Dưới đây, chúng tôi sẽ đề cập đến các tình huống sử dụng phổ biến nhất. Để biết thêm chi tiết, hãy xem tài liệu pip , bao gồm Hướng dẫn tham khảo.
Cài đặt từ PyPI¶
Cách sử dụng phổ biến nhất của pip là cài đặt từ Chỉ mục gói Python using a requirement specifier. Generally speaking, a requirement specifier is composed of a project name followed by an optional bộ xác định phiên bản tùy chọn. PEP 440 chứa thông số kỹ thuật đầy đủ của các bộ xác định hiện được hỗ trợ. Dưới đây là một số ví dụ.
Để cài đặt phiên bản mới nhất của “SomeProject”
Unix/macOS
py --version7các cửa sổ
py --version8
Để cài đặt một phiên bản cụ thể
Unix/macOS
py --version9các cửa sổ
>>> python --version Traceback [most recent call last]: File "", line 1, in NameError: name 'python' is not defined0
Để cài đặt lớn hơn hoặc bằng một phiên bản và nhỏ hơn một phiên bản khác
Unix/macOS
>>> python --version Traceback [most recent call last]: File "", line 1, in NameError: name 'python' is not defined1các cửa sổ
>>> python --version Traceback [most recent call last]: File "", line 1, in NameError: name 'python' is not defined2
Để cài đặt một phiên bản “tương thích” với một phiên bản nhất định. 4
Unix/macOS
>>> python --version Traceback [most recent call last]: File "", line 1, in NameError: name 'python' is not defined3các cửa sổ
>>> python --version Traceback [most recent call last]: File "", line 1, in NameError: name 'python' is not defined4
Trong trường hợp này, điều này có nghĩa là cài đặt bất kỳ phiên bản nào “==1. 4. *” cũng là “>=1. 4. 2”
Phân phối nguồn so với Bánh xe¶
pip có thể cài đặt từ Phân phối nguồn [sdist] hoặc Wheels, but if both are present on PyPI, pip will prefer a compatible wheel. You can override pip`s default behavior by e.g. using its –không nhị phân .
Bánh xe là định dạng phân phối dựng sẵn giúp cài đặt nhanh hơn so với Source Distributions [sdist], especially when a project contains compiled extensions.
Nếu pip không tìm thấy bánh xe để cài đặt, nó sẽ tạo cục bộ bánh xe và lưu vào bộ đệm cho các lần cài đặt sau, thay vì xây dựng lại .
Gói nâng cấp¶
Nâng cấp một
py --version80 đã được cài đặt lên phiên bản mới nhất từ PyPI
Unix/macOS
>>> python --version Traceback [most recent call last]: File "", line 1, in NameError: name 'python' is not defined5các cửa sổ
>>> python --version Traceback [most recent call last]: File "", line 1, in NameError: name 'python' is not defined6
Cài đặt vào trang web của người dùng¶
Để cài đặt gói được cách ly với người dùng hiện tại, hãy sử dụng cờ
py --version81.
Unix/macOS
>>> python --version Traceback [most recent call last]: File "", line 1, in NameError: name 'python' is not defined7các cửa sổ
>>> python --version Traceback [most recent call last]: File "", line 1, in NameError: name 'python' is not defined8
Để biết thêm thông tin, hãy xem phần Cài đặt người dùng từ tài liệu pip
Lưu ý rằng cờ
py --version81 không có tác dụng khi ở trong môi trường ảo - tất cả các lệnh cài đặt sẽ ảnh hưởng đến môi trường ảo
Nếu
py --version80 xác định bất kỳ tập lệnh dòng lệnh hoặc điểm nhập bảng điều khiển nào, thì
py --version81 sẽ khiến chúng được cài đặt bên trong thư mục nhị phân của cơ sở người dùng, thư mục này có thể đã có hoặc chưa có trong trình bao của bạn
py --version85. [Bắt đầu từ phiên bản 10, pip hiển thị cảnh báo khi cài đặt bất kỳ tập lệnh nào vào thư mục bên ngoài
py --version85. ] Nếu tập lệnh không có sẵn trong trình bao của bạn sau khi cài đặt, bạn sẽ cần thêm thư mục vào
py --version85 của mình
Trên Linux và macOS, bạn có thể tìm thấy thư mục nhị phân cơ sở người dùng bằng cách chạy
py --version
88 và thêmpy --version
89 vào cuối. Ví dụ: điều này thường sẽ inpy -m pip --version
60 [vớipy -m pip --version
61 được mở rộng thành đường dẫn tuyệt đối đến thư mục chính của bạn], vì vậy bạn sẽ cần thêmpy -m pip --version
62 vàopy --version
85 của mình. Bạn có thể đặt vĩnh viễnpy --version
85 của mình bằng cách sửa đổi ~/. Hồ sơTrên Windows, bạn có thể tìm thấy thư mục nhị phân cơ sở người dùng bằng cách chạy
py -m pip --version
65 và thay thếpy -m pip --version
66 bằngpy -m pip --version
67. Ví dụ: điều này có thể trả vềpy -m pip --version
68, vì vậy bạn cần đặtpy --version
85 của mình để bao gồmpy -m pip --version
70. Bạn có thể đặt vĩnh viễn người dùng của mìnhpy --version
85 trong Bảng điều khiển. Bạn có thể cần phải đăng xuất để thay đổipy --version
85 có hiệu lực
Hồ sơ yêu cầu¶
Cài đặt danh sách các yêu cầu được chỉ định trong Tệp yêu cầu .
Unix/macOS
>>> python --version Traceback [most recent call last]: File "", line 1, in NameError: name 'python' is not defined9các cửa sổ
In [1]: import sys !{sys.executable} --version Python 3.6.30
Cài đặt từ VCS¶
Cài đặt dự án từ VCS ở chế độ “có thể chỉnh sửa”. Để biết chi tiết đầy đủ về cú pháp, hãy xem phần của pip trên Hỗ trợ VCS .
Unix/macOS
In [1]: import sys !{sys.executable} --version Python 3.6.31các cửa sổ
In [1]: import sys !{sys.executable} --version Python 3.6.32
Cài đặt từ các Chỉ mục khác¶
Cài đặt từ một chỉ mục thay thế
Unix/macOS
In [1]: import sys !{sys.executable} --version Python 3.6.33các cửa sổ
In [1]: import sys !{sys.executable} --version Python 3.6.34
Tìm kiếm chỉ mục bổ sung trong khi cài đặt, ngoài PyPI
Unix/macOS
In [1]: import sys !{sys.executable} --version Python 3.6.35các cửa sổ
In [1]: import sys !{sys.executable} --version Python 3.6.36
Cài đặt từ cây src cục bộ¶
Cài đặt từ src cục bộ trong Chế độ phát triển , tôi. e. theo cách mà dự án dường như đã được cài đặt, nhưng vẫn có thể chỉnh sửa được từ cây src.
Unix/macOS
In [1]: import sys !{sys.executable} --version Python 3.6.37các cửa sổ
In [1]: import sys !{sys.executable} --version Python 3.6.38
Bạn cũng có thể cài đặt bình thường từ src
Unix/macOS
In [1]: import sys !{sys.executable} --version Python 3.6.39các cửa sổ
py --version40
Cài đặt từ kho lưu trữ cục bộ¶
Cài đặt một tệp lưu trữ nguồn cụ thể
Unix/macOS
py --version41các cửa sổ
py --version42
Cài đặt từ thư mục cục bộ chứa tệp lưu trữ [và không chọn PyPI ]
Unix/macOS
py --version43các cửa sổ
py --version44
Cài đặt từ các nguồn khác¶
Để cài đặt từ các nguồn dữ liệu khác [ví dụ: bộ lưu trữ Amazon S3], bạn có thể tạo ứng dụng trợ giúp trình bày dữ liệu ở định dạng chỉ mục tuân thủ PEP 503 và sử dụng cờ
py -m pip --version73 để chỉ đạo pip sử dụng chỉ mục đó
py --version45
Cài đặt bản phát hành trước¶
Tìm các phiên bản tiền phát hành và phát triển, ngoài các phiên bản ổn định. Theo mặc định, pip chỉ tìm thấy các phiên bản ổn định
Unix/macOS
py --version46các cửa sổ
py --version47
Cài đặt “Extras”¶
Các tính năng bổ sung là "biến thể" tùy chọn của một gói, có thể bao gồm các phần phụ thuộc bổ sung và do đó kích hoạt chức năng bổ sung từ gói. Nếu bạn muốn cài đặt một gói bổ sung cho một gói mà bạn biết đã xuất bản một gói, bạn có thể đưa nó vào lệnh cài đặt pip
Unix/macOS
py --version48các cửa sổ
py --version491
“An toàn” trong ngữ cảnh này có nghĩa là sử dụng trình duyệt hiện đại hoặc công cụ như curl để xác minh chứng chỉ SSL khi tải xuống từ URL https