Python模块和包的详细讲解_python的src.model在什么包里-CSDN博客

本文链接：https://blog.csdn.net/FAQEW/article/details/148000924

在 Python 中，模块（Module） 是代码组织的基本单位，用于将相关功能封装为可复用的文件。
在 Python 中，包（Package） 是一种用于组织多个模块的层级结构，它通过目录和特殊文件来实现代码的模块化管理。以下是 Python 模块，包的详细讲解。

1. 模块的基本概念

模块是什么？
一个 .py 文件即为一个模块，模块名是文件名（不含 .py 后缀）。
例如：math_utils.py 的模块名为 math_utils。
模块的作用
- 封装代码，避免命名冲突。
- 提高代码可维护性和复用性。
- 支持代码的按需加载（减少内存占用）。

2. 模块的导入与使用

(1) 导入整个模块

# 语法
import module_name

# 示例：导入内置模块 math
import math
print(math.sqrt(16))  # 4.0

(2) 导入模块中的特定功能

# 语法
from module_name import function_name, variable_name

# 示例：导入 sqrt 函数和 pi 常量
from math import sqrt, pi
print(sqrt(9))  # 3.0
print(pi)       # 3.141592653589793

(3) 为模块或功能起别名

# 语法
import module_name as alias
from module_name import function_name as fn_alias

# 示例：别名简化代码
import numpy as np
from datetime import datetime as dt

print(np.array([1, 2, 3]))
print(dt.now())

(4) 导入模块中所有功能（慎用！）

# 语法
from module_name import *

# 示例：导入 math 的所有功能（可能引发命名冲突）
from math import *
print(sin(pi/2))  # 1.0

注意：

避免使用 import *，可能导致命名冲突和代码可读性降低。
优先使用显式导入（明确列出需要导入的功能）。

3. 自定义模块

(1) 创建模块

创建一个 .py 文件并定义函数、类或变量。
示例：创建 string_utils.py：

# string_utils.py
def reverse_string(s):
    return s[::-1]

def count_vowels(s):
    vowels = 'aeiouAEIOU'
    return sum(1 for char in s if char in vowels)

version = "1.0"

(2) 使用自定义模块

# 导入自定义模块
import string_utils

s = "Hello, World!"
print(string_utils.reverse_string(s))  # "!dlroW ,olleH"
print(string_utils.count_vowels(s))    # 3
print(string_utils.version)            # "1.0"

4. 模块的搜索路径

当导入模块时，Python 会按以下顺序查找文件：

当前目录。
环境变量 PYTHONPATH 中列出的目录。
Python 的默认安装路径（如标准库目录）。

查看模块搜索路径：

import sys
print(sys.path)  # 输出所有搜索路径的列表

手动添加路径：

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

5. 包（Package）：模块的集合

包是什么？
一个包含 __init__.py 文件的目录（Python 3.3+ 后可以省略，但显式定义更清晰）（这个文件里面可以是空文件但是必须有这个文件）。
包用于组织多个模块，形成层次化结构。

包的结构示例：

my_package/
├── __init__.py       # 包的初始化文件（可以为空）
├── module1.py
└── subpackage/
    ├── __init__.py
    └── module2.py

导入包中的模块

# 导入子模块
from my_package import module1  # 这种方法可以直接使用module1里面的方法（推荐）
import my_package.subpackage.module2  #这种方法需要在调用的时候指定全路径，就比如说调用里面的hello()的方法需要my_package.subpackage.module2.hello()才能调用

# 或使用相对导入（在包内部使用）
# from . import module1

6. `init.py` 文件的作用

标识包：告诉 Python 该目录是一个包（即使文件内容为空）。
初始化包：在导入包或子包时，__init__.py 中的代码会自动执行。
控制导入行为：可以通过 __all__ 变量指定 from package import * 时导入哪些模块。

示例：定义 `init.py`

# my_package/__init__.py
print("Initializing my_package...")

# 定义 __all__ 变量，控制 from my_package import * 的行为
__all__ = ["module1", "subpackage"]

# 可以在此导入子模块，简化外部调用
from .module1 import some_function

7. 包的发布与安装

若想将包分享给他人或发布到 PyPI，需要配置 setuptools 工具。

(1) 基本项目结构

my_package/
├── setup.py          # 包的安装脚本
├── LICENSE           # 许可证文件
├── README.md         # 说明文档
└── my_package/       # 包源码
    ├── __init__.py
    └── module1.py

(2) 编写 `setup.py`

from setuptools import setup, find_packages

setup(
    name="my_package",
    version="0.1",
    packages=find_packages(),
    install_requires=["requests"],  # 依赖项
)

(3) 安装包

# 本地安装
pip install .

# 发布到 PyPI
python setup.py sdist bdist_wheel
twine upload dist/*

8. 模块的内置属性

每个模块都有一些特殊属性，例如：

__name__: 模块名称。
当模块直接运行时，__name__ 为 "__main__"；被导入时为模块名。
__file__: 模块的完整文件路径。
__doc__: 模块的文档字符串。

示例：

# my_module.py
"""
This is a docstring for my_module.
"""
print(f"Module name: {__name__}")
print(f"File path: {__file__}")

if __name__ == "__main__":
    print("This module is run directly!")

9. 模块的缓存与重载

模块缓存
Python 会缓存已导入的模块（存储在 sys.modules 中），避免重复加载。

强制重新加载模块
使用 importlib.reload()（开发调试时常用）：

import importlib
import my_module

# 修改 my_module 后重新加载
importlib.reload(my_module)

10. 常用内置模块示例

模块名	用途
`math`	数学运算
`os`	操作系统交互
`sys`	系统参数管理
`datetime`	日期时间处理
`json`	JSON 数据解析与生成
`random`	生成随机数
`re`	正则表达式操作

11. 第三方模块的安装

在这里插入图片描述

使用 pip 安装第三方模块：

pip install module_name  # 例如：pip install requests

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 包名 # 清华大学镜像仓库

使用pycharm安装