Python编程实战 - 函数与模块化编程 - 创建自己的模块与包除了使用 Python 自带的标准库，我们还可以创建自

模块化编程是 Python 最核心的思想之一。它能让我们把复杂的程序拆分成多个独立的文件（模块），让代码更清晰、更易维护、更易复用。除了使用 Python 自带的标准库，我们还可以创建自己的模块和包，让项目结构更专业、更易扩展。

一、什么是模块（Module）

在 Python 中，每一个 .py 文件都是一个模块。模块的作用就是封装功能代码，实现复用与逻辑分层。

例如，我们创建一个名为 mymath.py 的文件：

# mymath.py

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

def sub(a, b):
    return a - b

这就是一个简单的模块。我们可以在其他 Python 文件中导入并使用它。

# main.py
import mymath

print(mymath.add(3, 5))
print(mymath.sub(10, 4))

运行结果：

8
6

二、模块的导入方式

Python 提供多种导入模块的方式。

导入整个模块
```
import mymath
print(mymath.add(1, 2))
```

导入模块中的部分内容

from mymath import add
print(add(3, 5))

使用别名简化模块名

import mymath as mm
print(mm.add(2, 2))

三、模块的搜索路径

当我们导入模块时，Python 会按照一定顺序查找：

当前目录；
环境变量 PYTHONPATH 指定的路径；
Python 安装目录的标准库路径。

查看当前搜索路径：

import sys
print(sys.path)

如果你的模块不在默认路径中，可以手动添加：

import sys
sys.path.append("/path/to/your/module")

四、创建包（Package）

当项目中有多个模块时，我们可以将它们组织成一个包（Package）。包本质上是一个包含多个 .py 文件的目录，并且该目录中必须包含一个特殊文件：__init__.py。

示例：创建一个自定义包

项目结构如下：

myproject/
│
├── main.py
└── mypackage/
    ├── __init__.py
    ├── math_utils.py
    └── string_utils.py

1. math_utils.py

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

def sub(a, b):
    return a - b

2. string_utils.py

def capitalize_name(name):
    return name.capitalize()

3. init.py

__init__.py 可以是空文件，也可以用来定义包的初始化逻辑：

# mypackage/__init__.py
print("mypackage 已加载！")

4. main.py

from mypackage import math_utils, string_utils

print(math_utils.add(2, 3))
print(string_utils.capitalize_name("python"))

运行 main.py，输出：

mypackage 已加载！
5
Python

五、`init.py` 的作用

__init__.py 是包的“标识文件”，它让 Python 知道这个目录是一个包。你还可以在其中导出常用模块或函数，简化导入方式。

例如：

# mypackage/__init__.py
from .math_utils import add
from .string_utils import capitalize_name

这样在使用时可以直接导入：

from mypackage import add, capitalize_name

print(add(10, 5))
print(capitalize_name("tom"))

六、相对导入与绝对导入

在包内模块相互引用时，可以使用两种导入方式。

1. 绝对导入

from mypackage.string_utils import capitalize_name

2. 相对导入

在包内使用 . 和 .. 来表示层级关系：

from .string_utils import capitalize_name

相对导入在包结构复杂时非常方便，但只能在包内部使用。

七、包的嵌套结构

包可以包含子包，形成多层结构：

myproject/
│
└── mypackage/
    ├── __init__.py
    ├── math_utils.py
    └── tools/
        ├── __init__.py
        └── file_utils.py

导入时可以这样写：

from mypackage.tools.file_utils import read_file

八、模块的重载与调试技巧

在调试模块时，Python 只会在第一次导入时执行模块代码。如果修改了模块代码，可以使用 importlib.reload() 重新加载：

import mymath
from importlib import reload

reload(mymath)  # 重新加载模块

九、发布自己的模块或包

如果你希望其他人也能安装并使用你的模块，可以将其打包上传到 PyPI。简单步骤如下：

创建 setup.py：

from setuptools import setup, find_packages

setup(
    name='mypackage',
    version='1.0',
    packages=find_packages(),
    author='Your Name',
    description='A custom Python package example',
)

打包并上传：

python setup.py sdist bdist_wheel
twine upload dist/*

这样，其他人就可以通过：

pip install mypackage

直接安装使用你的模块。

十、总结

概念	说明	示例
模块（module）	一个 `.py` 文件	`mymath.py`
包（package）	包含 `__init__.py` 的文件夹	`mypackage/`
导入模块	`import mymath`	直接使用模块
从包导入	`from mypackage import math_utils`	使用包内功能
相对导入	`from .string_utils import func`	包内部引用

💡 实战案例：构建一个迷你工具包

项目结构：

tools/
├── __init__.py
├── math_tool.py
└── text_tool.py

math_tool.py

def square(x):
    return x * x

text_tool.py

def reverse(s):
    return s[::-1]

init.py

from .math_tool import square
from .text_tool import reverse

main.py

from tools import square, reverse

print(square(9))       # 输出 81
print(reverse("Python"))  # 输出 nohtyP

🎯 效果：

81
nohtyP

结语

创建自己的模块与包，是从 Python 初学者迈向专业开发者的重要一步。模块让代码复用，包让项目结构清晰。当你能熟练地拆分代码逻辑、组织模块关系、封装常用工具时，就已经具备了构建大型 Python 项目的能力。

Python编程实战 - 函数与模块化编程 - 创建自己的模块与包