要将你的 Python 项目发布到 **PyPI（Python Package Index）**，你需要完成以下步骤。这个过程包括：打包你的项目、创建必要的配置文件、构建发布包、上传到 PyPI。 --- ## ✅ 步骤详解：如何发布 Python 包到 PyPI ### 1. ✅ 准备工作 确保你已经完成以下事项： - 编写好你的 Python 项目。 - 安装了 `setuptools` 和 `wheel`（用于打包）。 - 安装了 `twine`（用于上传）。 ```bash pip install setuptools wheel twine ``` --- ### 2. ✅ 项目结构示例 一个标准的 Python 包结构如下： ``` my_package/ │ ├── my_package/ │ ├── __init__.py │ └── module.py │ ├── tests/ │ └── test_module.py │ ├── README.md ├── LICENSE └── pyproject.toml ``` --- ### 3. ✅ 创建 `pyproject.toml` 这是现代打包方式推荐的配置文件，替代 `setup.py`。 ```toml [build-system] requires = ["setuptools>=61.0", "wheel"] build-backend = "setuptools.build_meta" [project] name = "my_package" version = "0.1.0" authors = [ { name="Your Name", email="you@example.com" } ] description = "A small example package" readme = "README.md" license = { file="LICENSE" } classifiers = [ "Programming Language :: Python :: 3", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", ] requires-python = ">=3.7" ``` --- ### 4. ✅ 构建包 在项目根目录下运行以下命令： ```bash python -m build ``` 这会生成两个文件： - `dist/my_package-0.1.0-py3-none-any.whl`（wheel 包） - `dist/my_package-0.1.0.tar.gz`（源码包） --- ### 5. ✅ 注册 PyPI 账号 如果你还没有账号，前往 [https://pypi.org/account/register/](https://pypi.org/account/register/) 注册。 --- ### 6. ✅ 使用 `twine` 上传到 PyPI ```bash python -m twine upload dist/* ``` 系统会提示你输入 PyPI 的用户名和密码。 > ⚠️ **推荐使用 API token**： > 为了安全，建议在 PyPI 上创建 API token，并使用它进行上传。 ```bash python -m twine upload --username __token__ --password your-api-token dist/* ``` --- ### 7. ✅ 安装测试 发布成功后，你可以使用 pip 安装你的包： ```bash pip install my_package ``` --- ## ✅ 示例代码：简单的 `my_package` `my_package/__init__.py` 示例： ```python def greet(name: str) -> str: return f"Hello, {name}!" ``` 使用方式： ```python from my_package import greet print(greet("World")) ``` ---