Cài đặt mô-đun Python¶
Là một dự án phát triển nguồn mở phổ biến, Python có một cộng đồng hỗ trợ tích cực gồm những người đóng góp và người dùng, những người cũng cung cấp phần mềm của họ cho các nhà phát triển Python khác sử dụng theo các điều khoản cấp phép nguồn mở.
Điều này cho phép người dùng Python chia sẻ và cộng tác hiệu quả, hưởng lợi từ các giải pháp mà người khác đã tạo cho các vấn đề phổ biến (và đôi khi thậm chí hiếm gặp!), cũng như có khả năng đóng góp các giải pháp của riêng họ cho nhóm chung.
Hướng dẫn này bao gồm phần cài đặt của quá trình. Để biết hướng dẫn tạo và chia sẻ dự án Python của riêng bạn, hãy tham khảo Python packaging user guide.
Ghi chú
Đối với người dùng doanh nghiệp và tổ chức khác, hãy lưu ý rằng nhiều tổ chức có chính sách riêng của họ xung quanh việc sử dụng và đóng góp cho phần mềm nguồn mở. Vui lòng tính đến các chính sách đó khi sử dụng các công cụ phân phối và cài đặt được cung cấp cùng với Python.
Thuật ngữ chính¶
pip là chương trình cài đặt ưa thích. Theo mặc định, nó được bao gồm trong trình cài đặt nhị phân Python.
Zz000zz là môi trường Python bán biệt lập, cho phép cài đặt các gói để một ứng dụng cụ thể sử dụng, thay vì cài đặt trên toàn hệ thống.
venvlà công cụ tiêu chuẩn để tạo môi trường ảo. Nó mặc định cài đặt pip vào tất cả các môi trường ảo được tạo.virtualenvlà giải pháp thay thế của bên thứ ba (và tiền thân) chovenv.Zz000zz_ là kho lưu trữ công khai gồm các gói được cấp phép nguồn mở được cung cấp cho những người dùng Python khác sử dụng.
Zz000zz_ là nhóm các nhà phát triển và tác giả tài liệu chịu trách nhiệm duy trì và phát triển các công cụ đóng gói tiêu chuẩn cũng như các tiêu chuẩn định dạng tệp và siêu dữ liệu liên quan. Họ duy trì nhiều công cụ, tài liệu và trình theo dõi vấn đề trên GitHub.
Thay đổi trong phiên bản 3.5: Việc sử dụng venv hiện được khuyến nghị để tạo môi trường ảo.
Cách sử dụng cơ bản¶
Tất cả các công cụ đóng gói tiêu chuẩn đều được thiết kế để sử dụng từ dòng lệnh.
Lệnh sau sẽ cài đặt phiên bản mới nhất của mô-đun và các phần phụ thuộc của nó từ PyPI
python -m pip cài đặt SomePackage
Ghi chú
Đối với người dùng POSIX (bao gồm cả người dùng macOS và Linux), các ví dụ trong hướng dẫn này giả định việc sử dụng virtual environment.
Đối với người dùng Windows, các ví dụ trong hướng dẫn này giả định rằng tùy chọn điều chỉnh biến môi trường PATH của hệ thống đã được chọn khi cài đặt Python.
Cũng có thể chỉ định phiên bản chính xác hoặc tối thiểu trực tiếp trên dòng lệnh. Khi sử dụng các toán tử so sánh như >, < hoặc một số ký tự đặc biệt khác được shell giải thích, tên gói và phiên bản phải được đặt trong dấu ngoặc kép
python -m pip cài đặt SomePackage==phiên bản 1.0.4 # specific
python -m pip cài đặt phiên bản "SomePackage>=1.0.4" # minimum
Thông thường, nếu một mô-đun phù hợp đã được cài đặt, việc cố gắng cài đặt lại nó sẽ không có tác dụng. Việc nâng cấp các mô-đun hiện có phải được yêu cầu rõ ràng:
cài đặt python -m pip --nâng cấp SomePackage
Bạn có thể tìm thấy thêm thông tin và tài nguyên về pip và các khả năng của nó trong Python Packaging User Guide.
Việc tạo môi trường ảo được thực hiện thông qua mô-đun venv. Việc cài đặt các gói vào môi trường ảo đang hoạt động sử dụng các lệnh hiển thị ở trên.
Làm sao tôi...?¶
Đây là những câu trả lời hoặc liên kết nhanh cho một số nhiệm vụ phổ biến.
... cài đặt các gói chỉ dành cho người dùng hiện tại?¶
Việc chuyển tùy chọn --user sang python -m pip install sẽ cài đặt một gói chỉ dành cho người dùng hiện tại chứ không phải cho tất cả người dùng hệ thống.
... cài đặt các gói Python khoa học?¶
Một số gói Python khoa học có các phần phụ thuộc nhị phân phức tạp và hiện không dễ cài đặt trực tiếp bằng pip. Người dùng thường sẽ dễ dàng cài đặt các gói này bằng other means hơn là cố gắng cài đặt chúng bằng pip.
... hoạt động với nhiều phiên bản Python được cài đặt song song?¶
Trên Linux, macOS và các hệ thống POSIX khác, hãy sử dụng các lệnh Python đã được phiên bản kết hợp với khóa chuyển -m để chạy bản sao thích hợp của pip:
python3 -m pip cài đặt SomePackage # default Python 3
python3.14 -m pip cài đặt SomePackage # specifically Python 3.14
Các lệnh pip được phiên bản phù hợp cũng có thể có sẵn.
Trên Windows, sử dụng trình khởi chạy Python py kết hợp với khóa chuyển -m
py -3 -m pip cài đặt SomePackage # default Python 3
py -3.14 -m pip cài đặt SomePackage # specifically Python 3.14
Các vấn đề cài đặt thường gặp¶
Cài đặt vào hệ thống Python trên Linux¶
Trên các hệ thống Linux, bản cài đặt Python thường sẽ được đưa vào như một phần của bản phân phối. Việc cài đặt vào bản cài đặt Python này yêu cầu quyền truy cập root vào hệ thống và có thể cản trở hoạt động của trình quản lý gói hệ thống cũng như các thành phần khác của hệ thống nếu một thành phần được nâng cấp bất ngờ bằng pip.
Trên các hệ thống như vậy, tốt hơn nên sử dụng môi trường ảo hoặc cài đặt cho mỗi người dùng khi cài đặt các gói bằng pip.
Pip chưa được cài đặt¶
Có thể pip không được cài đặt theo mặc định. Một cách khắc phục tiềm năng là:
python -m đảm bảopip --default-pip
Ngoài ra còn có các tài nguyên bổ sung cho installing pip.
Cài đặt phần mở rộng nhị phân¶
Python từng phụ thuộc rất nhiều vào phân phối dựa trên nguồn, với việc người dùng cuối phải biên dịch các mô-đun mở rộng từ nguồn như một phần của quá trình cài đặt.
Với sự ra đời của định dạng bánh xe nhị phân và khả năng xuất bản các bánh xe thông qua PyPI, vấn đề này sẽ giảm bớt vì người dùng thường xuyên có thể cài đặt các tiện ích mở rộng dựng sẵn thay vì cần phải tự xây dựng chúng.
Một số giải pháp cài đặt scientific software chưa có sẵn dưới dạng tệp bánh xe dựng sẵn cũng có thể giúp lấy các phần mở rộng nhị phân khác mà không cần phải xây dựng chúng cục bộ.