【python】导入模块or包（一）

在Python中，导入模块或者包非常简单，主要通过import关键字来完成。

一、包（package）和模块（module）

在Python中，包（package）和模块（module）都是组织代码的方式，但它们之间存在一些重要的区别：

1、模块（Module）

• 定义：模块是一个包含Python定义和语句的文件，其文件扩展名为.py。简单来说，一个.py文件就是一个模块。
• 内容：模块可以包含函数、类、变量和/或其他可执行的代码。
• 用途：模块通常用于封装一组相关的函数和类，以便在更大的应用程序中使用。
• 导入方式：可以使用import语句直接导入一个模块，或者从模块中导入特定的函数、类、变量等。

2、包（Package）

• 定义：包是一个包含多个模块的文件夹（目录），该文件夹必须包含一个名为__init__.py的文件（可以是空文件）。这个__init__.py文件用于标识该文件夹是一个Python包。
• 内容：包可以包含多个模块、子包（即嵌套在其他包中的包）和其他资源文件。
• 用途：包用于将多个模块组织成一个逻辑单元，从而提供更好的代码组织性和可维护性。它还可以避免命名冲突，因为不同的包可以有相同名称的模块。
• 导入方式：包中的模块需要通过包的名称和模块名称来导入。例如，如果有一个名为mypackage的包，其中包含一个名为mymodule的模块，那么可以使用from mypackage import mymodule来导入这个模块。

3、关键点区别

1. 结构：模块是单个文件，而包是包含多个模块（文件）的文件夹（目录）。
2. 内容：模块包含Python代码，而包可以包含模块、子包和其他资源文件。
3. 用途：模块用于封装相关的函数和类，而包用于将多个模块组织成一个逻辑单元。
4. 导入：模块可以直接导入，而包中的模块需要通过包的名称和模块名称来导入。

二、导入模块的基本方法

1. 导入整个模块

如果想要使用模块中的所有功能，可以直接导入整个模块。

import math

# 使用模块中的函数或变量时，需要通过模块名来引用
result = math.sqrt(16)
print(result)  # 输出 4.0

2. 从模块中导入特定的函数或变量

如果只需要使用模块中的某几个函数或变量，可以使用from ... import ...语法来导入它们。

from math import sqrt

# 直接使用函数，不需要模块名前缀
result = sqrt(16)
print(result)  # 输出 4.0

3. 从模块中导入多个特定的函数或变量

可以一次性导入多个函数或变量。

from math import sqrt, pow

result1 = sqrt(16)
result2 = pow(2, 3)
print(result1)  # 输出 4.0
print(result2)  # 输出 8.0

4. 导入模块并为其指定别名

如果导入的模块名与当前文件的代码中的其他名称冲突，或者模块名太长不便于使用，可以为其指定一个别名。

import math as m

result = m.sqrt(16)
print(result)  # 输出 4.0

5. 导入自定义模块

如果有一个自定义的Python文件（比如my_module.py），并且该文件与的主脚本在同一个目录下，或者在Python的搜索路径中，可以直接导入它。

import my_module

# 使用my_module中定义的函数、类等

6. 动态导入模块

还可以使用importlib模块来动态地导入模块。这在编写插件系统或需要动态加载模块时非常有用。

import importlib

# 假设我们有一个名为'dynamic_module'的模块
module_name = 'dynamic_module'
module = importlib.import_module(module_name)

# 使用module中定义的函数、类等

三、导入包的基本方法

在Python中，通常不会“导入一整个包”，因为包本身并不包含直接可执行的代码（除了__init__.py文件可能包含一些初始化代码）。然而，可以通过几种方式来使用包中的内容。其实导的还是模块。

1. 使用import关键字导入包中的模块**：

这是最常见的方式。可以直接导入包中的特定模块。

import mypackage.mymodule

# 使用 mymodule 中的内容
mypackage.mymodule.some_function()

2. 使用from .....import关键字导入包中的模块**：

from mypackage import mymodule

# 使用mymodule中定义的函数、类等

3. 在__init__.py中定义__all__来导入包中所有模块**：

如果想要在导入包时自动导入包中的所有子模块，可以在包的__init__.py文件中定义一个名为__all__的列表，其中包含想要导入的子模块的名称。然后，可以使用from package import *来导入所有列在__all__中的模块。

# mypackage/__init__.py
__all__ = ['mymodule1', 'mymodule2']

# 另一个文件
from mypackage import *

# 现在可以使用 mymodule1 和 mymodule2 中的内容
mymodule1.some_function()
mymodule2.another_function()

但是一般不会使用`from package import *`，因为它可能命名冲突。

4. 使用pkgutil或importlib动态导入包中的模块**：

如果需要根据某些条件动态地导入包中的模块，可以使用pkgutil或importlib模块。这些模块提供了更高级的导入功能，允许根据包的名称动态地查找和导入模块。

import importlib

# 动态地导入 mypackage 中的 mymodule
module = importlib.import_module('mypackage.mymodule')

# 使用 mymodule 中的内容
module.some_function()

5. 使用importlib.resources或pkg_resources来访问包中的资源**：

如果有一个包包含非python文件（如配置文件、数据文件、图像等），你可以使用importlib.resources（在Python 3.7+中引入）或pkg_resources（来自setuptools）来访问这些资源。

注意事项

• 确保模块文件（.py）的命名符合Python的命名规范，即使用小写字母和下划线（snake_case）。
• 避免循环依赖，即一个模块导入另一个模块，而另一个模块又导回第一个模块。这会导致难以追踪的错误。

敲黑板：
导包其实还是得导入到具体的模块。