Một mô-đun là một file chứa các định nghĩa và câu lệnh Python. Tên file là tên mô-đun có thêm hậu tố `.py`. Trong mô-đun, tên của mô-đun \ (dưới dạng chuỗi \) được lưu sẵn trong giá trị của biến toàn cục`__name__`. Ví dụ, sử dụng trình soạn thảo văn bản yêu thích của bạn để tạo một file có tên là `fibo.py` trong thư mục hiện tại với các nội dung sau:

Bây giờ vào trình thông dịch Python và import mô-đun này bằng lệnh sau: & gt; & gt; & gt;

Chỗ này không đưa tên của các hàm được định nghĩa trong `fibo` trực tiếp vào trong bảng ký hiệu hiện tại; nó chỉ đưa tên mô-đun 'fibo` thôi. Sau đó sử dụng tên mô-đun, bạn có thể truy cập các hàm: & gt; & gt; & gt;

Nếu bạn định sử dụng hàm thường xuyên, bạn có thể gán nó cho một tên cục bộ: & gt; & gt; & gt;

Cách này không đưa tên mô-đun vào những thứ được import vào bảng symbol cục bộ \ (ví dụ, trong ví dụ, `fibo` không được sẽ không được thêm vào bảng \).

Thậm chí còn có một biến thể để import tất cả các tên mà mô-đun đã định nghĩa nữa: & gt; & gt; & gt;

Đoạn này sẽ nhập tất cả các định nghĩa trừ các tên bắt đầu bằng dấu gạch dưới \ (`_` \). Trong hầu hết các trường hợp, các lập trình viên Python không sử dụng cách này vì nó sẽ đưa một số tên không được hiểu rõ vào trình thông dịch, dẫn đến có nguy cơ một số tên trùng bị ghi đè giá trị hay mất giá trị được gán lúc trước.

Lưu ý rằng nói chung, việc import sử dụng `*` từ một mô-đun hoặc gói được không được khuyến khích, vì nó làm cho code trở nên khó đọc. Tuy nhiên, bạn có thể sử dụng nó để đỡ phải gõ nhiều khi làm việc ở chế độ tương tác.

Nếu tên mô-đun được theo sau bởi [`as`] (https://docs.python.org/3/reference/compound_stmts.html#as), thì tên phía sau [` as`] (https: // docs. python.org/3/reference/compound_stmts.html#as) được liên kết trực tiếp với mô-đun đã nhập. & gt; & gt; & gt;

Điều này là để import các mô-đun như cách mà `import fibo` làm, chỉ có sự khác biệt duy nhất giờ có một cái tên là ` fib` được định nghĩa thôi.

Nó cũng có thể dùng được khi sử dụng [`from`] (https://docs.python.org/3/reference/simple_stmts.html#from) với các tác dụng tương tự: & gt; & gt; & gt;

Chú thích

Khi bạn chạy một mô-đun Python với

code trong mô-đun sẽ được thực hiện, sẽ giống như khi bạn import nó, nhưng với giá trị `__name__` được gán là ` "__main __" `. Điều đó có nghĩa là bằng cách thêm mã này vào cuối mô-đun của bạn:

bạn có thể làm cho file vừa có thể được sử dụng làm script cũng vừa là một mô-đun, bởi vì code cái đọc giá trị từ dòng lệnh chỉ chạy nếu mô-đun được thực thi dưới dạng file "main":

Nếu mô-đun được import, thì code sẽ không chạy: & gt; & gt; & gt;

Điều này thường được sử dụng cho việc hoặc là cung cấp một giao diện người dùng thuận tiện cho một mô-đun, hoặc cho mục đích kiểm thử \ (chạy mô-đun như một scrip thực hiện một loạt test case \).

Python đi kèm với một thư viện các mô-đun chuẩn, được mô tả trong một tài liệu riêng biệt, Tham khảo Thư viện Python \ ("Tham khảo Thư viện" sau đây \). Một số mô-đun được tích hợp vào trình thông dịch; chúng cung cấp quyền truy cập vào các hoạt động không phải là một phần cốt lõi của ngôn ngữ nhưng vẫn được tích hợp sẵn, hoặc để có hiệu quả hoặc cung cấp quyền truy cập vào các nguyên bản của hệ điều hành như các cuộc gọi hệ thống. Tập hợp các mô-đun như vậy là một tùy chọn cấu hình cũng phụ thuộc vào nền tảng cơ bản. Ví dụ, mô-đun [`winreg`] (https://docs.python.org/3/library/winreg.html#module-winreg) chỉ được cung cấp trên các hệ thống Windows. Một mô-đun đặc biệt đáng chú ý: [`sys`] (https://docs.python.org/3/library/sys.html#module-sys), được xây dựng trong mọi trình thông dịch Python. Các biến `sys.ps1` và` sys.ps2` xác định các chuỗi được sử dụng làm lời nhắc chính và phụ: & gt; & gt; & gt;

Hai biến này chỉ được xác định nếu trình thông dịch ở chế độ tương tác.

Biến `sys.path` là một danh sách các chuỗi xác định đường dẫn tìm kiếm của trình thông dịch cho các mô-đun. Nó được khởi tạo cho một đường dẫn mặc định được lấy từ biến môi trường [`PYTHONPATH`] (https://docs.python.org/3/using/cmdline.html#envvar-PYTHONPATH), hoặc từ một mặc định dựng sẵn nếu [ `PYTHONPATH`] (https://docs.python.org/3/using/cmdline.html#envvar-PYTHONPATH) chưa được đặt. Bạn có thể sửa đổi nó bằng cách sử dụng các hoạt động danh sách chuẩn: & gt; & gt; & gt;

Hàm dựng sẵn [`dir ()`] (https://docs.python.org/3/library/functions.html#dir) được sử dụng để tìm ra tên mà mô-đun xác định. Nó trả về danh sách các chuỗi được sắp xếp: & gt; & gt; & gt;

Không có đối số, [`dir ()`] (https://docs.python.org/3/library/functions.html#dir) liệt kê các tên bạn đã xác định hiện tại: & gt; & gt; & gt;

Lưu ý rằng nó liệt kê tất cả các loại tên: biến, mô-đun, chức năng, v.v.

[`dir ()`] (https://docs.python.org/3/library/functions.html#dir) không liệt kê tên của các hàm và biến tích hợp sẵn. Nếu bạn muốn một danh sách, chúng được định nghĩa trong mô-đun chuẩn [`builtins`] (https://docs.python.org/3/library/builtins.html#module-builtins): & gt; & gt; & gt;

Các gói là một cách để cấu trúc không gian tên mô-đun của Python bằng cách sử dụng "tên mô-đun chấm chấm". Ví dụ, tên module `AB` chỉ định một mô-đun con có tên là` B` trong một gói có tên `A`. Cũng giống như việc sử dụng các mô-đun tiết kiệm cho các tác giả của các mô-đun khác nhau phải lo lắng về tên biến toàn cục của nhau, việc sử dụng tên mô-đun chấm chấm lưu các tác giả của các gói đa mô-đun như NumPy hoặc Pillow khỏi phải lo lắng về các tên mô-đun của nhau .

Giả sử bạn muốn thiết kế một tập hợp các mô-đun \ (một "gói" \) để xử lý thống nhất các file âm thanh và dữ liệu âm thanh. Có nhiều định dạng file âm thanh khác nhau \ (thường được nhận dạng bởi phần mở rộng của chúng, ví dụ: `.wav`,` .aiff`, `.au` \), vì vậy bạn có thể cần tạo và duy trì một tập hợp các mô-đun ngày càng tăng cho chuyển đổi giữa các định dạng file khác nhau. Cũng có nhiều thao tác khác nhau mà bạn có thể muốn thực hiện trên dữ liệu âm thanh \ (chẳng hạn như trộn, thêm echo, áp dụng hàm cân bằng, tạo hiệu ứng stereo nhân tạo \), ngoài ra bạn sẽ viết luồng mô-đun không bao giờ kết thúc để thực hiện các hoạt động này. Đây là một cấu trúc có thể cho gói của bạn \ (được biểu thị bằng hệ thống file phân cấp \):

Khi nhập gói, Python tìm kiếm thông qua các thư mục trên `sys.path` để tìm thư mục con của gói.

Các file `__init __. Py` được yêu cầu để làm cho Python xử lý các thư mục có chứa các gói; điều này được thực hiện để ngăn các thư mục có tên chung, chẳng hạn như `chuỗi`, từ vô tình ẩn các mô-đun hợp lệ xảy ra sau này trên đường dẫn tìm kiếm mô-đun. Trong trường hợp đơn giản nhất, `__init __. Py` chỉ có thể là một file rỗng, nhưng nó cũng có thể thực thi mã khởi tạo cho gói hoặc đặt biến` __all__`, được mô tả sau.

Người dùng của gói có thể nhập các mô-đun riêng lẻ từ gói, ví dụ:

Điều này tải submodule `sound.effects.echo`. Nó phải được tham chiếu với tên đầy đủ của nó.

Một cách khác để nhập mô-đun con là:

Điều này cũng nạp submodule `echo`, và làm cho nó có sẵn mà không có tiền tố gói của nó, vì vậy nó có thể được sử dụng như sau:

Tuy nhiên, một biến thể khác là nhập hàm hoặc biến mong muốn trực tiếp:

Một lần nữa, điều này nạp submodule `echo`, nhưng điều này làm cho hàm của nó` echofilter () `có sẵn trực tiếp:

Lưu ý rằng khi sử dụng `từ mục nhập gói`, mục có thể là một mô-đun con (hoặc gói con \) của gói, hoặc một số tên khác được định nghĩa trong gói, như một hàm, lớp hoặc biến. Câu lệnh `import` đầu tiên kiểm tra xem mục được định nghĩa trong gói; nếu không, nó giả định nó là một mô-đun và cố gắng tải nó. Nếu nó không tìm thấy nó, một ngoại lệ [`ImportError`] (https://docs.python.org/3/library/exceptions.html#ImportError) được nâng lên.

Giải pháp duy nhất là dành cho tác giả gói để cung cấp chỉ mục rõ ràng về gói. Câu lệnh [`import`] (https://docs.python.org/3/reference/simple_stmts.html#import) sử dụng quy ước sau đây: nếu mã` __init __. Py` của một gói định nghĩa một danh sách có tên `__all__`, nó được lấy là danh sách các tên mô-đun cần được nhập khi `từ gói nhập * * gặp phải. Tùy thuộc vào tác giả gói để cập nhật danh sách này khi phiên bản mới của gói được phát hành. Tác giả gói cũng có thể quyết định không hỗ trợ nó, nếu họ không thấy sử dụng để nhập \ * từ gói của họ. Ví dụ, file `sound / effects / __ init __. Py` có thể chứa đoạn mã sau:

Điều này có nghĩa là `from sound.effects import *` sẽ nhập ba tên con được đặt tên là `sound`package.

Nếu `__all__` không được định nghĩa, câu lệnh` from sound.effects import * `hiện _not_ import tất cả các submodules từ gói` sound.effects` vào không gian tên hiện tại; nó chỉ đảm bảo rằng gói `sound.effects` đã được nhập \ (có thể chạy bất kỳ mã khởi tạo nào trong` __init __. py` \) và sau đó import bất kỳ tên nào được định nghĩa trong gói. Điều này bao gồm bất kỳ tên được định nghĩa \ (và submodules được nạp một cách rõ ràng \) bởi `__init __. Py`. Nó cũng bao gồm bất kỳ mô-đun con nào của gói được tải một cách rõ ràng bằng các câu lệnh [`import`] (https://docs.python.org/3/reference/simple_stmts.html#import) trước đó. Hãy xem xét mã này:

Mặc dù các mô-đun nhất định được thiết kế để chỉ xuất các tên theo một số mẫu nhất định khi bạn sử dụng `import *`, nó vẫn được coi là thực hành không tốt trong mã sản xuất.

Bạn cũng có thể viết import tương đối, với dạng `from module import name` của câu lệnh import. Các mục nhập này sử dụng các dấu chấm đầu để chỉ ra các gói hiện tại và cha mẹ có liên quan đến việc nhập tương đối. Từ ví dụ `surround`module, bạn có thể sử dụng:

Lưu ý rằng import tương đối dựa trên tên của mô-đun hiện tại. Vì tên của mô-đun chính luôn là `" __main __ "`, các mô-đun được sử dụng làm mô đun chính của ứng dụng Python phải luôn sử dụng import tuyệt đối.