Python自定义模块的创建、导入与打包详解

一、前言

Python语言具备强大的模块支持体系，这不仅体现在标准库中内置的大量标准模块，还体现在丰富的第三方模块生态中，同时开发者也完全有能力开发并应用自定义模块。充分利用这些模块资源，能够显著简化开发流程，大幅提升编程效率。

二、模块的概述

模块（Module）的概念可以类比为“一盒主题积木”。通过组合盒内的积木，可以构建出特定主题的内容。这与函数有所不同：函数好比单块积木，而模块则包含多个函数（即多块积木），因此模块可被视为一盒完整的积木集合。

在Python中，任何扩展名为“.py”的文件均被视为一个模块。通常，我们将实现特定功能的代码封装在一个独立的文件中作为模块，以便其他程序或脚本通过导入机制来调用。此外，使用模块还有助于避免不同代码片段中函数名或变量名的命名冲突。

随着Python程序的规模扩大，为了便于维护，通常需要将代码拆分到多个文件中。这种模块化设计不仅提高了代码的可维护性，还增强了代码的可重用性。一旦某个模块编写完成并实现特定功能，其他需要该功能的程序只需导入该模块即可直接使用，无需重复编写代码。

三、自定义模块

在Python中，自定义模块主要发挥两个作用：一是规范代码结构，提升代码的可读性；二是方便其他程序复用已编写的代码，从而提高整体开发效率。实现自定义模块主要涉及两个步骤：创建模块文件和导入模块。

1.创建模块

创建模块的核心是将相关的代码（包括变量定义、函数定义等）编写在一个单独的文件中，并将该文件命名为“模块名.py”。简而言之，创建自定义模块的过程实际上就是创建一个以“.py”为扩展名的文件。

注意：

• 在创建模块时，应避免使用与Python内置标准模块名称相同的模块名，以防产生冲突。
• 模块文件的扩展名必须严格为“.py”。

2.使用import语句导入模块

模块创建完成后，即可在其他程序中调用。要使用模块，首先需要加载模块中的代码，这可以通过import语句实现。import语句的基本语法格式如下：

import modulename [as alias]

参数说明：

• modulename：指定要导入的模块名称。
• [as alias]：可选参数，用于为导入的模块指定一个别名。

例如，导入名为test的模块，并执行该模块中的getInfo()函数，代码如下：

import test    # 导入test模块
test.getInfo() # 执行模块中的getInfo()函数

可以使用关键字as为导入的模块指定别名，代码如下：

import test as m  # 导入test模块，并将test别名为m
m.getInfo() # 执行模块中的getInfo()函数

使用import语句一次可以导入多个模块，模块之间使用逗号“,”分隔。例如，同时导入test.py、data.py和tips.py三个模块文件，代码如下：

import test,data,tips

虽然import语句支持一次导入多个模块，但通常不建议采用这种方式，以保持代码清晰。

3.使用from…import语句导入模块

使用import语句导入模块时，每次执行都会创建一个新的命名空间（namespace），并在该空间中执行.py文件的相关语句。使用时，需要在具体的变量、函数或类名前加上“模块名.”前缀。如果希望避免每次导入都创建新命名空间，而是将具体的定义直接导入当前命名空间，可以使用from…import语句。使用该语句导入后，无需添加前缀，可直接通过变量、函数或类名进行访问。

from…import语句的语法格式如下：

from modelname import member

参数说明：

• modelname：模块名称，区分大小写，必须与定义模块时设置的名称完全一致。
• member：指定要导入的变量、函数或类等。可以同时导入多个定义，各定义间用逗号“,”分隔。若要导入模块中的所有定义，可使用通配符星号“*”代替。

例如，通过以下3条语句均可从模块导入指定的定义：

from test import getInfo          # 导入test模块的getInfo()函数
from test import getInfo,showInfo # 导入test模块的getInfo()和showInfo()函数
from test import *                # 导入test模块的全部定义（包括变量和函数）

注意：

使用from…import语句导入模块定义时，需确保所有导入的内容在当前命名空间中唯一。若出现同名变量、函数或类，后导入的会覆盖先导入的，导致冲突。此时建议改用import语句进行导入。

附：python打包用户自定义模块

假设需要打包的模块文件名为my.py，打包模块需要新建一个脚本setup.py，然后在脚本中输入如下内容：

from disutils.core import setup
setup{name = 'my',version = '1.0',py_modules = ['my']}

以管理员身份运行cmd，进入my.py所在目录，执行以下命令即可进行打包：

python setup.py sdist

运行后，在该目录下会生成一个dist文件夹。进入该文件夹，可以看到一个my-1.0.zip压缩包。将此压缩包放入sys.path指定的目录下，解压后，以管理员身份运行cmd，进入解压目录，执行下方命令即可自动安装my模块。

python setup.py install

完成安装后，即可在程序中加载my模块：

import my

总结

至此，关于Python自定义模块的创建与使用介绍完毕。如需了解更多Python自定义模块相关内容，建议搜索本站历史文章或继续浏览后续相关文章，感谢大家的支持！