Python语法之模块和包

Posted 2022-10-08

这一节，我将为大家介绍模块和包：

在开发大型软件时，随着代码写的越来越多，如果将所有的代码都放在一个文件里，势必为以后的维护带来很大的困难。正如仓颉造字一样，仓颉是黄帝的史官，用祖传结绳记事的老办法记载史实。时间一长，那些大大小小，奇形怪状的绳结都记了些什么，连他自己也没法辨认了。于是，仓颉开始想新的办法，用什么方式可以帮助大家分辨清不同的事物，在仓颉的努力下，他创造了文字，解决了这个问题。而在 Python 中，为了编写易于维护的代码，我们会将代码拆分放到不同的文件里，这样每个文件包含的代码相对就会减少。在 Python 中，一个 .py 文件称为一个模块（Module）。

模块化能够带来很多好处： （1）简化问题求解 将所有代码放在一个文件中时，我们需要考虑的是整个问题的求解，代码实现的复杂度大大增加。将代码拆分放在多个文件中时，每个文件只需要对子问题进行求解，代码实现的复杂度大大降低。 （2）提高代码可维护性 由于解决不同子问题的代码放在了不同的文件中，代码之间的依赖性小，其中一个文件的修改对其他文件产生影响的几率大大降低。维护人员可以对其中一个文件的代码进行修改，而不必熟悉其他文件中的代码。由于每个文件专注于解决一个子问题，文件之间的并行开发成为可能。 （3）提高代码可重用性 一个模块编写完成后，可以被其他地方引用。我们在编写程序的时候，也可以引用其他模块，包括 Python 内置的模块和来自第三方的模块。这样就不需要重复造轮子。大大提高了代码的复用性和开发效率。 （4）减少代码冲突 模块提供了一个独立的命名空间，独立命名空间的好处是可以避免函数名和变量名冲突。相同名字的函数和变量可以放在不同的模块中。因此，我们自己在编写模块时，不必考虑名字会与其他模块冲突。但是也要注意，尽量不要与内置函数名字冲突。 了解了模块是什么之后，我们一起来看下如何创建模块？

1. 模块的创建

模块的创建非常简单，一个 .py 文件便是一个模块（Module）。将下面的代码保存在 utils.py 文件中，这个操作是非常简单的，只需要我们创建一个文件名为 utils 的 py 文件，然后将代码复制到 utils 的 py 文件中就完成了一个模块的创建。

# utils.py模块
def max_num(a, b):
    if a >= b:
        return a
    else:
        return b


def min_num(a, b):
    if a > b:
        return b
    else:
        return

这样我们便创建了一个名为 utils 的模块，在这个模块中，定义了两个函数： max_num和min_num ，两个函数分别为求两个数中的大数和小数。

2. 模块的导入

2.1import <module_name>

模块创建完成后，可以使用 import 关键字来导入模块，例如：

import

我们看到通过 import 模块名 的方式完成了模块导入。 执行上述指令后，Python 首先会从自己内置模块中查找是否含有该模块的定义，若未查询到会从 sys.path 对应的模块路径查询是否含有对应模块的定义，如果搜索完成，仍然没有对应的模块时，则抛出 import 的异常。 也就是说当执行 import utils 这条指令时，Python 会从以下路径中搜索模块 utils.py 。 在当前目录下搜索该模块。 在环境变量 PYTHONPATH 指定的路径列表中依次搜索。 在 Python 安装路径的 lib 库中搜索。 上述路径可以通过变量 sys.path 获得，该变量位于模块 sys 中。sys.path是 Python 的一个系统变量，是 Python 搜索模块的路径列表。其获取的方法如下：

import sys

print(sys.path)

为了让创建的模块能够被找到，需要将模块放到上述路径中的一个，因为 Python 只会在这些路径中去查找模块，如果没有将模块创建在这些路径中，则找不到对应的模块，也就没办法应用模块中的对象和方法了。 现在呢，我们想要去调用模块 utils 中的 max_num 和 min_num 方法，第一步为导入模块 utils，第二步为调用模块 utils 中的两个方法，具体语句如下：

#导入模块utils
import utils

print(utils.max_num(4, 5))
print(utils.min_num(4, 5))

下一节接着讲模块创建的其他属性。。。

2.2 from <module_name> import <name(s)>

下面，我们一起来看模块导入的另一种方法，直接导入模块中的对象，语句为：from 模块名 import 方法名，我们一起看下方实例：

from utils import max_num, min_num

print(max_num(4, 5))
print(min_num(4, 5))

使用这种方式导入时，调用 max_num 和 min_num 函数便不需要添加前缀 utils.。 有时候，为了方便，会使用 from <module_name> import * 来导入模块中的所有对象。

from utils import *

print(max_num(4, 5))
print(min_num(4, 5))

2.3 from <module_name> import as <alt_name>

Python 中模块内的对象和方法也可以有自己的别名，实现语句为： from 模块名 import *** as 别名 ，该命令为导入的对象起一个别名。这样就可以通过别名来使用对象。例如：

from utils import max_num as max_n, min_num as min_n

print(max_n(4, 5))
print(min_n(4, 5))

在上面的例子中，分别为 max_num,min_num 取了别名 max_n,min_n。这样在调用函数时，便可以使用 max_n,min_n。

2.4 import <module_name> as <alt_name>

我们还可以为导入的整个模块起一个别名，这样便可以通过模块的别名来使用模块，使用方法是一样的，都是将 模块名. 作为前缀。例如：

import utils as ul

print(ul.max_num(4, 5))
print(ul.min_num(4, 5))

在上面的例子中，为模块 utils 取了别名 ul，这样在调用函数时，便可以使用 ul. 前缀。

2.5 包含单个类的模块

一起来看下包含单个类的模块，我们创建一个模块(car.py)，包含类 car ，语句如下：

class Car:
    def __init__(self, mk, md, y, c):
        self.make = mk
        self.model = md
        self.year = y
        self.color = c
        self.mileage = 0

    def get_description(self):
        description = fself.year self.color self.make self.model
        print(description)

    def get_mileage(self):
        print(f"This car has self.mileage)

    def update_mileage(self, mile):
        self.mileage = mile

导入类(my_car.py)：

from car import Car

my_car = Car(audi, a4, 2016, white)
my_car.get_description()
my_car.update_mileage(30)
my_car.get_mileage()

2.6 包含多个类的模块

我们创建模块(car.py)，其中包含父类 car 和继承类 Electriccar ，语句如下：

class Car:
    def __init__(self, mk, md, y, c):
        self.make = mk
        self.model = md
        self.year = y
        self.color = c
        self.mileage = 0

    def get_description(self):
        description = fself.year self.color self.make self.model
        print(description)

    def get_mileage(self):
        print(f"This car has self.mileage)

    def update_mileage(self, mile):
        self.mileage = mile


class ElectricCar(Car):
    def __init__(self, mk, md, y, c):
        super().__init__(mk, md, y, c)
        self.battery_size = 100

    def get_battery(self):
        print(f"This car has self.battery_size)

导入单个类(my_electirc_car.py):

from car import ElectricCar

my_tesla = ElectricCar(tesla, model 3, 2018, white)
my_tesla.get_description()
my_tesla.get_battery()

导入多个类(my_cars.py):

from car import ElectricCar, Car

my_car = Car(audi, a4, 2016, white)
my_car.update_mileage(30)
my_car.get_mileage()

my_tesla = ElectricCar(tesla, model 3, 2018, white)
my_tesla.get_description()
my_tesla.get_battery()

导入整个模块：

import car

my_car = car.Car(audi, a4, 2016, white)
my_car.update_mileage(30)
my_car.get_mileage()

my_tesla = car.ElectricCar(tesla, model 3, 2018, white)
my_tesla.get_description()
my_tesla.get_battery()

导入模块中的全部类：

from car import *

my_car = Car(audi, a4, 2016, white)
my_car.update_mileage(30)
my_car.get_mileage()

my_tesla = ElectricCar(tesla, model 3, 2018, white)
my_tesla.get_description()
my_tesla.get_battery()

3. 包

在程序中呢，也会遇到和仓颉一样的问题，就是假设我们开发了一个很庞大的应用程序，程序包含了非常多的模块。随着模块数量的增长，如果将模块都放在同一个目录下，将变得越来越难管理。特别当模块具有相似的名称或相似的功能。这时候我们非常希望对这些模块进行分组管理，Python 中的包实现了对模块分组管理的功能。包的创建非常简单，它利用了操作系统的分层文件结构。我们只要将模块放在一个目录下便可。

在上图中，目录 pkg 下有两个模块，utils1.py 和 utils2.py，pkg 便是一个包。（包相当于一个文件夹，模块则相当于文件夹中的文件） 两个模块中的语句如下：（语句相当于文件中的内容） utils1.py:

def max_num(a, b):
    if a >= b:
        return a
    else:
        return b


def min_num(a, b):
    if a > b:
        return b
    else:
        return

utils2.py:

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


def abs_num(a):
    if a >= 0:
        return a
    else:
        return

3.1 import <module_name>[, <module_name> ...]

导入包中的模块，语法规则为：import 包.模块名，我们一起看下方语句：

import pkg.utils1
import pkg.utils2

print(pkg.utils1.max_num(4, 5))
print(pkg.utils2.sum_num(4, 5))

导入包 pkg 中的模块 utils1 和模块 utils2，并调用两个模块中的方法，将 pkg.utils1. 作为前缀放在 max_num()方法前，表示是在 pkg 包中的模块 utils1 内的方法。

3.2 from <package_name> import <modules_name>[, <module_name> ...]

我们也可以通过 from 语句来实现模块的导入，我们一起看下方语句：

from pkg import utils1, utils2

print(utils1.max_num(4, 5))
print(utils2.sum_num(4, 5))

3.3 from <module_name> import <name(s)>

我们再来一起看下，定义包之后，导入指定模块中的对象，我们看下方语句：

from pkg.utils1 import max_num

print(max_num(4, 5))

和第二部分模块导入相比，就是在模块名前将包的名字作为前缀 pkg.utils1 来实现的，其余语句均与模块导入一致。

3.4 from <module_name> import as <alt_name>

为模块内的对象和方法设置别名，语句如下：

from pkg.utils1 import max_num as max_n

print(max_n(4, 5))

3.5 from <package_name> import <module_name> as <alt_name>

为导入的整个模块设置别名，语句如下：

from pkg import utils1 as ul1

print(ul1.max_num(4, 5))

4. 小试牛刀

自定义一个模块，并在另一个文件中导入这个模块。