Python 模块Module与包Package最佳实践

# 1. 导入整个模块
import math  # 导入Python内置math模块
print(math.pi)  # 调用模块中的变量：3.141592653589793
print(math.sqrt(16))  # 调用模块中的函数：4.0
# 2. 导入模块并指定别名（简化调用）
import numpy as np
print(np.array([1,2,3]))  # 别名调用
# 3. 导入模块中的指定内容（函数/变量/类）
from math import pi, sqrt
print(pi)  # 直接使用，无需加模块名
print(sqrt(25))  # 5.0
# 4. 导入模块中的所有内容（不推荐，易冲突）
from math import *
print(cos(0))  # 1.0

# my_module.py
# 定义变量
version = "1.0"
# 定义函数
def add(a, b):
    return a + b
# 定义类
class Calculator:
    def multiply(self, a, b):
        return a * b
# 可执行代码（仅模块直接运行时执行）
if __name__ == "__main__":
    print("模块自身运行时执行")
    print(add(2, 3))  # 5

# main.py
# 导入自定义模块
import my_module
print(my_module.version)  # 1.0
print(my_module.add(3, 4))  # 7
calc = my_module.Calculator()
print(calc.multiply(2, 5))  # 10

my_package/          # 根包
├── __init__.py      # 包初始化文件
├── utils.py         # 子模块1：工具函数
├── data/            # 子包
│   ├── __init__.py
│   └── handler.py   # 子模块2：数据处理
└── model/           # 子包
    ├── __init__.py
    └── user.py      # 子模块3：用户模型

# 1. 导入包中的模块
import my_package.utils
print(my_package.utils.add(1, 2))  # 假设utils.py有add函数
# 2. 导入模块并指定别名
import my_package.data.handler as data_handler
data_handler.read_file("test.txt")  # 调用handler.py的函数
# 3. 直接导入模块中的函数/类
from my_package.model.user import User
user = User("Alice")  # 实例化User类
# 4. 从包中导入模块（简化）
from my_package import utils
print(utils.add(3, 4))

# my_package/__init__.py
# 1. 定义包级变量
__version__ = "2.0"
# 2. 导入核心模块，简化外部调用
from .utils import add
from .data.handler import read_file

import my_package
print(my_package.__version__)  # 2.0
print(my_package.add(2, 3))    # 5
my_package.read_file("test.txt")

from my_package.data import handler

# 在my_package/model/user.py中导入同级utils
from ..utils import add  # .. 表示上级目录（my_package/）

import sys
print(sys.path)  # 查看当前搜索路径
# 临时添加自定义路径（仅本次运行有效）
sys.path.append("/home/user/custom_module")

requests==2.31.0
numpy==1.26.0