Đường dẫn tìm kiếm mô-đun được khởi tạo khi Python bắt đầu. Đường dẫn tìm kiếm mô-đun này có thể được truy cập tại sys.path
Mục đầu tiên trong đường dẫn tìm kiếm mô-đun là thư mục chứa tập lệnh đầu vào, nếu có. Mặt khác, mục nhập đầu tiên là thư mục hiện tại, đây là trường hợp khi thực thi shell tương tác, lệnh -c hoặc mô-đun -m
Biến môi trường PYTHONPATH thường được sử dụng để thêm các thư mục vào đường dẫn tìm kiếm. Nếu tìm thấy biến môi trường này thì nội dung sẽ được thêm vào đường dẫn tìm kiếm mô-đun
Ghi chú
PYTHONPATH sẽ ảnh hưởng đến tất cả các phiên bản/môi trường Python đã cài đặt. Hãy cảnh giác với cài đặt này trong cấu hình trình bao của bạn hoặc các biến môi trường toàn cầu. Mô-đun site cung cấp nhiều kỹ thuật sắc thái hơn như được đề cập bên dưới
Các mục tiếp theo được thêm vào là các thư mục chứa các mô-đun Python chuẩn cũng như bất kỳ mô-đun mở rộng nào mà các mô-đun này phụ thuộc vào. Các mô-đun mở rộng là các tệp .pyd trên Windows và tệp .so trên các nền tảng khác. Thư mục chứa các mô-đun Python độc lập với nền tảng được gọi là prefix. Thư mục với các mô-đun mở rộng được gọi là sys.path0.
Biến môi trường sys.path1 có thể được sử dụng để đặt các vị trí prefix và sys.path0. Mặt khác, các thư mục này được tìm thấy bằng cách sử dụng tệp thực thi Python làm điểm bắt đầu và sau đó tìm kiếm các tệp và thư mục 'mốc' khác nhau. Lưu ý rằng mọi liên kết tượng trưng đều được tuân theo để vị trí thực thi Python thực được sử dụng làm điểm bắt đầu tìm kiếm. Vị trí thực thi Python được gọi là sys.path4
Sau khi xác định được sys.path4, thư mục prefix được tìm thấy bằng cách tìm kiếm đầu tiên cho sys.path7 [sys.path8]. Trên Windows, kho lưu trữ zip được tìm kiếm trong sys.path4 và trên Unix, kho lưu trữ dự kiến sẽ có trong -c0. Lưu ý rằng vị trí lưu trữ zip dự kiến sẽ được thêm vào đường dẫn tìm kiếm mô-đun ngay cả khi kho lưu trữ không tồn tại. Nếu không tìm thấy kho lưu trữ nào, Python trên Windows sẽ tiếp tục tìm kiếm prefix bằng cách tìm kiếm -c2. Python trên Unix sẽ tìm kiếm -c3 [-c4]. Trên Windows, prefix và sys.path0 giống nhau, tuy nhiên trên các nền tảng khác, -c7 [-c8] được tìm kiếm và sử dụng làm điểm neo cho sys.path0. Trên một số nền tảng, -c0 có thể là -m1 hoặc một giá trị khác, xem -m2 và -m3
Sau khi được tìm thấy, prefix và sys.path0 có sẵn tại -m6 và -m7 tương ứng
Cuối cùng, mô-đun site được xử lý và thư mục -m9 được thêm vào đường dẫn tìm kiếm mô-đun. Một cách phổ biến để tùy chỉnh đường dẫn tìm kiếm là tạo các mô-đun PYTHONPATH0 hoặc PYTHONPATH1 như được mô tả trong tài liệu mô-đun site
Ghi chú
Một số tùy chọn dòng lệnh có thể ảnh hưởng đến tính toán đường dẫn. Xem PYTHONPATH3, PYTHONPATH4, PYTHONPATH5 và PYTHONPATH6 để biết thêm chi tiết
Môi trường ảo¶
Nếu Python được chạy trong môi trường ảo [như được mô tả tại Môi trường ảo và gói ] thì prefix và sys.path0 dành riêng cho môi trường ảo.
Nếu tệp PYTHONPATH9 được tìm thấy cùng với tệp thực thi chính hoặc trong thư mục cao hơn tệp thực thi một cấp, các biến thể sau sẽ được áp dụng
Nếu
sys.path4 là một đường dẫn tuyệt đối vàsys.path1 không được đặt, thì đường dẫn này được sử dụng thay cho đường dẫn đến tệp thực thi chính khi suy raprefixvàsys.path0
tệp _pth¶
Để ghi đè hoàn toàn sys.path, hãy tạo tệp PYTHONPATH5 có cùng tên với thư viện dùng chung hoặc tệp thực thi [PYTHONPATH6 hoặc PYTHONPATH7]. Đường dẫn thư viện dùng chung luôn được biết trên Windows, tuy nhiên, đường dẫn này có thể không khả dụng trên các nền tảng khác. Trong tệp PYTHONPATH5 chỉ định một dòng cho mỗi đường dẫn để thêm vào sys.path. Tệp dựa trên tên thư viện dùng chung sẽ ghi đè tệp dựa trên tệp thực thi, cho phép hạn chế đường dẫn đối với bất kỳ chương trình nào đang tải thời gian chạy nếu muốn
Khi tệp tồn tại, tất cả các biến đăng ký và môi trường sẽ bị bỏ qua, chế độ cách ly được bật và site không được nhập trừ khi một dòng trong tệp chỉ định site1. Các đường dẫn và dòng trống bắt đầu bằng site2 bị bỏ qua. Mỗi đường dẫn có thể là tuyệt đối hoặc tương đối với vị trí của tệp. Các câu lệnh nhập khác với site không được phép và mã tùy ý không thể được chỉ định
Lưu ý rằng các tệp site4 [không có dấu gạch dưới ở đầu] sẽ được mô-đun site xử lý bình thường khi site1 đã được chỉ định