> For the complete documentation index, see [llms.txt](https://gitbook.fantasticmao.cn/tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.fantasticmao.cn/tech/python/python-mo-kuai.md).

# Python 模块

## 模块详解

Python 把各种定义存入一个文件，用于在脚本或解释器的交互式实例中，这个文件就是模块。

模块包含可执行语句及函数定义，这些语句用于初始化模块，且仅在 import 语句第一次遇到模块名时执行。

每个模块都有它自己的私有符号表，该表被定义在该模块里的所有函数当作全局符号表使用。

## 模块搜索路径

当导入一个名为 spam 的模块时，解释器首先会搜索具有该名称的内置模块（`sys.builtin_module_names` 中列出了所有内置模块的名称）。如果未找到，它将在变量 `sys.path` 所给出的目录列表中搜索名为 spam.py 的文件。`sys.path` 是从这些位置初始化的:

* 被命令行直接运行的脚本所在的目录（或未指定文件时的当前目录）。
* `PYTHONPATH`（目录列表，与 shell 变量 `PATH` 的语法一样）。
* 依赖于安装的默认值（按照惯例包括一个 site-packages 目录，由 site 模块处理）。