首先创建标准目录结构并添加__init__.py文件，接着编写setup.py和pyproject.toml配置元数据，最后通过build工具构建并本地安装包进行验证。
如果您尝试构建一个可重用的Python模块集合，但不知道如何组织代码结构或正确声明包信息，可能是由于缺乏对Python包结构的理解。以下是创建Python包的具体步骤：
一、准备包的基本结构
一个标准的Python包需要具备特定的目录结构，以便被Python解释器识别为可安装和导入的模块单元。该结构包含初始化文件和功能模块。
1、创建项目根目录，例如命名为 my_python_package。
2、在根目录下新建一个同名的子目录，如 my_python_package，用于存放实际的Python代码。
立即学习“Python免费学习笔记（深入）”；
3、在该子目录中添加 __init__.py 文件，即使为空，也需存在以标识其为Python包。
4、在包目录内创建具体的模块文件，例如 utils.py 或 core.py，并编写所需函数或类。
5、在根目录下创建其他必要文件，包括 setup.py、README.md 和 pyproject.toml（如果使用现代构建系统）。
二、编写 setup.py 配置文件
setup.py 是包的元数据描述文件，定义了包名、版本、依赖项等关键信息，是打包和发布的基础。
1、在项目根目录创建 setup.py 文件。
2、写入以下内容：
from setuptools import setup, find_packages
setup(
name='my_python_package',
version='0.1.0',
packages=find_packages(),
description='A sample Python package',
author='Your Name',
author_email='your.email@example.com',
install_requires=[
'requests',
'click'
python_requires='>=3.7'
)
三、使用 pyproject.toml 替代 setup.py
现代Python项目推荐使用 pyproject.toml 来声明构建系统和依赖关系，避免直接依赖 setuptools 在运行时的存在。
1、在项目根目录创建 pyproject.toml 文件。
2、添加以下内容：
[build-system]
requires = ["setuptools>=45", "wheel"]
build-backend = "setuptools.build_meta"
[project]
name = "my_python_package"
version = "0.1.0"
description = "A sample Python package"
authors = [{name = "Your Name", email = "your.email@example.com"}]
dependencies = [
"requests",
"click"
]
requires-python = ">=3.7"
四、构建和本地安装包
完成配置后，可以将项目构建成可分发的格式，并进行本地测试安装，确保包能正常工作。
1、打开终端并进入项目根目录。
2、运行命令安装构建工具：pip install build。
3、执行构建命令：python -m build，生成 dist/ 目录下的 .whl 和 .tar.gz 文件。
4、使用 pip 安装生成的包：pip install dist/my_python_package-0.1.0-py3-none-any.whl。
5、在另一个Python脚本中尝试导入：from my_python_package.utils import some_function，验证是否成功。
