引言

Python 模块是包含代码的文件，可以定义函数、类和变量，并被其他 Python 程序导入。模块是 Python 编程的基础组件之一，能够提高代码的复用性和组织性。本文将介绍模块的基本概念、常用操作及一些高级技巧。

什么是模块？
模块是包含 Python 代码的文件。它可以定义函数、类或变量。模块可以被其他 Python 程序导入。

示例：
创建一个名为 utils.py 的模块文件：

# utils.py

def add(a, b):
    """
    返回 a 和 b 的和。
    """
    return a + b

def subtract(a, b):
    """
    返回 a 减去 b 的差。
    """
    return a - b

如何导入并使用这个模块？

import utils

result = utils.add(10, 5)
print(result)  # 输出: 15

result = utils.subtract(10, 5)
print(result)  # 输出: 5

使用 from ... import ... 导入模块中的特定部分

可以只导入模块中的某些函数或类，而不是整个模块。

示例：

from utils import add, subtract

result = add(10, 5)
print(result)  # 输出: 15

result = subtract(10, 5)
print(result)  # 输出: 5

创建包以组织相关模块

包是一个包含多个模块的目录。它通常用于组织相关的模块。
示例：
假设有一个名为 math_package 的包，其中包含两个模块：addition.py 和 subtraction.py。

目录结构：

math_package/
    __init__.py
    addition.py
    subtraction.py

addition.py：

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

subtraction.py：

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

如何导入并使用这些模块？

from math_package.addition import add
from math_package.subtraction import subtract

result = add(10, 5)
print(result)  # 输出: 15

result = subtract(10, 5)
print(result)  # 输出: 5

使用 all 控制导入行为

可以在模块中定义一个 all 列表，以控制 from module import * 语句导入的内容。
示例：
修改 utils.py 文件：

# utils.py

__all__ = ['add', 'subtract']

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

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

def _private_function():
    print("这是一个私有函数")

如何导入并使用这个模块？

from utils import *

result = add(10, 5)
print(result)  # 输出: 15

result = subtract(10, 5)
print(result)  # 输出: 5

_private_function()  # 报错：NameError: name '_private_function' is not defined

由于 _private_function 不在 all 列表中，因此不能通过 from utils import * 导入它。

避免循环导入问题

循环导入是指两个模块互相导入对方，这会导致错误。
示例：
假设有两个模块 a.py 和 b.py。

a.py：
def func_a():
    print("这是模块 a 中的函数")

import b

b.py：
def func_b():
    print("这是模块 b 中的函数")

import a

如何避免循环导入问题？

可以将函数定义移到导入语句之后。

修改后的 a.py：

def func_a():
    print("这是模块 a 中的函数")

import b

修改后的 b.py：

def func_b():
    print("这是模块 b 中的函数")

import a

现在不会出现循环导入的问题了。

使用相对导入

相对导入允许在一个包内的模块之间导入其他模块。

示例：
假设有一个名为 math_package 的包，其中包含三个模块：addition.py、subtraction.py 和 multiplication.py。

目录结构：

math_package/
    __init__.py
    addition.py
    subtraction.py
    multiplication.py

multiplication.py：

from .addition import add
from .subtraction import subtract

def multiply(a, b):
    result = add(a, b)
    result = subtract(result, a)
    return result * b

如何测试这个模块？

from math_package.multiplication import multiply

result = multiply(10, 5)
print(result)  # 输出: 50

使用 if name == "main" 运行模块测试代码

当模块被导入时，它的代码会自动执行。为了避免这种情况，可以在模块中添加一个检查 name 变量的条件语句。

示例：
修改 utils.py 文件：

# utils.py

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

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

if __name__ == "__main__":
    print(add(10, 5))  # 输出: 15
    print(subtract(10, 5))  # 输出: 5

如何导入并使用这个模块？

import utils

result = utils.add(10, 5)
print(result)  # 输出: 15

result = utils.subtract(10, 5)
print(result)  # 输出: 5

当你直接运行 utils.py 文件时，会输出测试结果：

$ python utils.py
15
5

但是，当你导入 utils 模块时，测试代码不会被执行。

使用 reload 重新加载模块

在开发过程中，经常需要修改模块并重新加载它们。可以使用 importlib.reload 函数来重新加载模块。

示例：
首先，导入 importlib 模块：

import importlib
import utils

result = utils.add(10, 5)
print(result)  # 输出: 15

# 修改 utils.py 文件，例如将 add 函数改为：
# def add(a, b):
#     return a + b + 1

# 保存更改后重新加载模块

importlib.reload(utils)

result = utils.add(10, 5)
print(result)  # 输出: 16

使用 init.py 初始化包

init.py 文件用于初始化包。在这个文件中可以定义包级别的变量、函数或类。

示例：
假设有一个名为 math_package 的包，其中包含一个 init.py 文件和两个模块：addition.py 和 subtraction.py。

目录结构：

math_package/
    __init__.py
    addition.py
    subtraction.py

init.py：
def package_add(a, b):
    return a + b

__all__ = ['package_add']

addition.py：
def add(a, b):
    return a + b

subtraction.py：
def subtract(a, b):
    return a - b

如何导入并使用这个包？

import math_package

result = math_package.package_add(10, 5)
print(result)  # 输出: 15

from math_package import package_add

result = package_add(10, 5)
print(result)  # 输出: 15

使用命名空间包

命名空间包允许将多个独立的子包合并成一个包。这对于大型项目非常有用，可以更好地组织代码。
示例：

假设有一个名为 my_project 的命名空间包，其中包含两个子包：math_package 和 string_package。

目录结构：

my_project/
    math_package/
        __init__.py
        addition.py
        subtraction.py
    string_package/
        __init__.py
        format_string.py

math_package/init.py：
def package_add(a, b):
    return a + b

__all__ = ['package_add']

math_package/addition.py：
def add(a, b):
    return a + b

math_package/subtraction.py：
def subtract(a, b):
    return a - b

string_package/init.py：
def format_string(s):
    return s.upper()

__all__ = ['format_string']

string_package/format_string.py：
def format(s):
    return s.upper()

如何导入并使用这个命名空间包？

import my_project.math_package
import my_project.string_package

result = my_project.math_package.package_add(10, 5)
print(result)  # 输出: 15

formatted_string = my_project.string_package.format_string("hello world")
print(formatted_string)  # 输出: HELLO WORLD

实战案例：创建一个简单的日志模块

假设我们需要为一个项目创建一个日志模块，用于记录程序的运行信息。
需求：

日志模块应该能够记录不同级别的日志信息，包括 debug, info, warning, error 和 critical。2. 日志模块应该能够将日志信息输出到控制台和文件。3. 日志模块应该支持自定义日志格式。

实现步骤：

创建一个名为 logger.py 的模块文件。2. 使用 logging 库来实现日志记录功能。
logger.py：

import logging

def setup_logger(name, log_file, level=logging.INFO):
    """设置日志记录器"""
    formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')

    handler = logging.FileHandler(log_file)
    handler.setFormatter(formatter)

    logger = logging.getLogger(name)
    logger.setLevel(level)
    logger.addHandler(handler)

    stream_handler = logging.StreamHandler()
    stream_handler.setFormatter(formatter)
    logger.addHandler(stream_handler)

    return logger

# 设置日志记录器
logger = setup_logger('root_logger', 'app.log')

def debug(msg):
    logger.debug(msg)

def info(msg):
    logger.info(msg)

def warning(msg):
    logger.warning(msg)

def error(msg):
    logger.error(msg)

def critical(msg):
    logger.critical(msg)

如何使用这个日志模块？

import logger

logger.debug("这是一条调试信息")
logger.info("这是一条信息")
logger.warning("这是一条警告信息")
logger.error("这是一条错误信息")
logger.critical("这是一条严重错误信息")

输出结果：

控制台输出：
2024-10-01 10:00:00,000 - DEBUG - 这是一条调试信息
2024-10-01 10:00:00,000 - INFO - 这是一条信息
2024-10-01 10:00:00,000 - WARNING - 这是一条警告信息
2024-10-01 10:00:00,000 - ERROR - 这是一条错误信息
2024-10-01 10:00:00,000 - CRITICAL - 这是一条严重错误信息

日志文件 app.log 输出：
2024-10-01 10:00:00,000 - DEBUG - 这是一条调试信息
2024-10-01 10:00:00,000 - INFO - 这是一条信息
2024-10-01 10:00:00,000 - WARNING - 这是一条警告信息
2024-10-01 10:00:00,000 - ERROR - 这是一条错误信息
2024-10-01 10:00:00,000 - CRITICAL - 这是一条严重错误信息

总结

本文介绍了 Python 模块的基本概念和常用操作，包括如何创建和使用模块、导入特定部分、创建包、控制导入行为、避免循环导入问题、使用相对导入、运行测试代码、重新加载模块、初始化包以及使用命名空间包等。此外，还提供了一个实战案例，展示了如何创建一个简单的日志模块。这些技巧有助于提高代码的组织性和可维护性。

原创文章。转载请注明：作者:meixi 网址: https://www.icnma.com

Python中创建和使用模块的技巧

实战案例：创建一个简单的日志模块

总结

猜你想看

Pandas平替Polars

free cursor

functools高级编程技巧，Python代码优雅神器

langchain结合云原生Milvus向量数据库问答实践指南

FastAPI + NGINX + Gunicorn：部署一个高性能的Python应用