《Python 打包与发布全景解析：从 setuptools 到 Poetry 的最佳实践》

《Python 打包与发布全景解析：从 setuptools 到 Poetry 的最佳实践》

---

一、开篇引入：为什么要学习打包与发布？

Python 的发展历程从 1991 年 Guido van Rossum 发布第一个版本开始，凭借简洁优雅的语法和强大的生态，逐渐成为 Web 开发、数据科学、人工智能、自动化脚本等领域的首选语言。
然而，随着项目规模的扩大，如何将代码打包成可复用的模块并发布到 PyPI 或企业内部仓库，成为每一位开发者必须掌握的技能。

打包与发布不仅仅是技术细节，它代表着：

• 知识共享：让你的工具和库被更多人使用。
• 工程规范：统一依赖管理，提升团队协作效率。
• 职业成长：开源贡献与技术积累，提升个人影响力。

本文将结合多年实战经验，带你从 基础打包流程 到 现代工具 Poetry 的最佳实践，全面解析 Python 项目的发布之道。

---

二、Python 打包的基础认知

1. 什么是打包？

打包就是将你的 Python 项目整理成一个标准化的结构，使其可以被安装、分发和复用。
最终产物通常是一个 wheel 文件（.whl） 或 源码包（.tar.gz）。

2. 为什么要发布？

• 内部团队共享：避免重复造轮子。
• 开源贡献：发布到 PyPI，服务全球开发者。
• 自动化部署：CI/CD 流程中自动安装依赖。

---

三、项目结构规范

一个标准的 Python 项目结构如下：

myproject/
│── myproject/
│   ├── __init__.py
│   ├── core.py
│── tests/
│   ├── test_core.py
│── README.md
│── LICENSE
│── setup.py
│── pyproject.toml
│── requirements.txt

关键文件说明：

• setup.py：传统 setuptools 配置文件。
• pyproject.toml：现代打包配置文件，Poetry 等工具依赖。
• README.md：项目说明文档。
• LICENSE：开源协议。
• tests/：单元测试目录。

---

四、使用 setuptools 打包与发布

1. 安装 setuptools

pip install setuptools wheel twine

2. 编写 setup.py

from setuptools import setup, find_packa