6.1 模块基础

6.1.1 理论知识

模块是一个包含Python定义和语句的文件，其扩展名为 .py。模块可以将代码组织成逻辑单元，提高代码的可维护性和复用性。通过将相关的函数、类和变量放在同一个模块中，可以方便地在不同的程序中使用这些代码。

在Python中，要使用模块，需要先导入它。导入模块后，就可以访问模块中定义的内容。

6.1.2 示例代码

假设我们有两个文件，module1.py 和 main.py。

module1.py：

def add_numbers(a, b):
    return a + b


def multiply_numbers(a, b):
    return a * b

main.py：

import module1

result1 = module1.add_numbers(3, 5)
result2 = module1.multiply_numbers(2, 4)
print(f"两数之和: {result1}")
print(f"两数之积: {result2}")

6.1.3 代码解释

• 在 module1.py 中定义了两个函数 add_numbers 和 multiply_numbers，分别用于执行加法和乘法运算。
• 在 main.py 中，使用 import module1 导入了 module1 模块。导入后，可以通过模块名加函数名的方式（module1.add_numbers 和 module1.multiply_numbers）来调用模块中定义的函数，并将结果打印出来。

6.2 导入模块的不同方式

6.2.1 import语句

这是最基本的导入方式，如前面示例所示，使用 import module_name 导入整个模块，通过 module_name.function_name 来访问模块中的函数或其他对象。

6.2.2 from...import语句

理论知识：使用 from module_name import object_name 可以从模块中导入特定的对象（函数、类、变量等），这样在使用时就不需要通过模块名作为前缀。

示例代码：

from module1 import add_numbers, multiply_numbers

result1 = add_numbers(3, 5)
result2 = multiply_numbers(2, 4)
print(f"两数之和: {result1}")
print(f"两数之积: {result2}")

代码解释：从 module1 模块中直接导入了 add_numbers 和 multiply_numbers 函数，所以在调用这两个函数时，不需要使用模块名前缀，直接使用函数名即可。

6.2.3 from...import *语句

理论知识：from module_name import * 会导入模块中的所有公共对象（没有以下划线开头的对象）。虽然这种方式使用起来很方便，但可能会导致命名冲突，不推荐在大型项目中使用。

示例代码：

from module1 import *

result1 = add_numbers(3, 5)
result2 = multiply_numbers(2, 4)
print(f"两数之和: {result1}")
print(f"两数之积: {result2}")

代码解释：与上一个示例类似，导入了 module1 中的所有公共对象，因此可以直接调用函数。但如果当前命名空间中已有与 module1 中同名的对象，就会产生命名冲突。

6.3 模块的搜索路径

6.3.1 理论知识

当Python解释器导入一个模块时，它会按照一定的顺序在多个地方查找该模块。搜索路径包括以下几个部分：

• 当前目录：首先会在当前执行脚本所在的目录中查找模块。
• Python标准库目录：包含Python自带的标准库模块，如 os、sys 等。
• 环境变量 PYTHONPATH 包含的目录：PYTHONPATH 是一个环境变量，它可以包含多个目录路径，Python会在这些目录中查找模块。

可以通过 sys.path 来查看Python解释器的搜索路径列表。

6.3.2 示例代码

import sys
print(sys.path)

6.3.3 代码解释

运行这段代码会打印出 sys.path 的内容，即Python解释器在导入模块时会搜索的路径列表。列表中的第一个元素通常是当前目录，后续是Python标准库目录以及 PYTHONPATH 中包含的目录（如果设置了的话）。

6.4 包（Package）

6.4.1 理论知识

包是一种管理Python模块命名空间的方式，它本质上是一个包含 __init__.py 文件的目录。包可以包含多个模块和子包，用于将相关的模块组织在一起，形成层次化的结构。

在Python 3.3及以上版本，__init__.py 文件可以为空，但它仍然用于标识该目录是一个Python包。

6.4.2 示例代码

假设我们有以下目录结构：

my_package/
    __init__.py
    module1.py
    sub_package/
        __init__.py
        module2.py

module1.py：

def func1():
    print("这是 module1 中的 func1")

module2.py：

def func2():
    print("这是 module2 中的 func2")

main.py：

from my_package import module1
from my_package.sub_package import module2

module1.func1()
module2.func2()

6.4.3 代码解释

• 我们创建了一个名为 my_package 的包，其中包含 module1.py 和一个子包 sub_package。子包 sub_package 又包含 module2.py。
• 在 main.py 中，通过 from my_package import module1 导入了 my_package 包中的 module1 模块，通过 from my_package.sub_package import module2 导入了子包 sub_package 中的 module2 模块。
• 然后分别调用 module1 中的 func1 函数和 module2 中的 func2 函数，输出相应的信息。

6.5 __name__变量

6.5.1 理论知识

每个Python模块都有一个内置变量 __name__。当模块作为主程序运行时，__name__ 的值为 '__main__'；当模块被导入到其他模块中时，__name__ 的值为模块本身的名称。

这个变量常用于在模块中编写一些测试代码，使得模块既可以被导入使用，又可以独立运行进行测试。

6.5.2 示例代码

module1.py：

def add_numbers(a, b):
    return a + b


if __name__ == '__main__':
    result = add_numbers(2, 3)
    print(f"在模块内部测试，两数之和: {result}")

main.py：

import module1

result = module1.add_numbers(5, 7)
print(f"在主程序中调用，两数之和: {result}")

6.5.3 代码解释

• 在 module1.py 中，定义了 add_numbers 函数。if __name__ == '__main__': 块中的代码只有在 module1.py 作为主程序直接运行时才会执行。这里用于在模块内部进行简单的测试，计算并打印 2 + 3 的结果。
• 在 main.py 中，导入 module1 模块并调用 add_numbers 函数，计算并打印 5 + 7 的结果。此时 module1.py 中的测试代码不会执行，因为 module1 是被导入，其 __name__ 不是 '__main__'。