setuptools 是 Python 社区中广泛使用的分发工具之一，它扩展了标准库中的 distutils 模块，并提供了更多强大的功能，使得开发者可以更方便地创建、管理和安装 Python 包。setuptools 的核心目标是简化包的构建和发布流程，并增强对依赖管理和动态发现的支持[^1]。 ### 功能与用途 #### 1. **自动依赖管理** setuptools 允许在 `setup.py` 文件中指定项目所需的依赖项（通过 `install_requires` 参数），在安装时会自动下载并安装这些依赖包。例如： ```python from setuptools import setup setup( name='MyApp', version='1.0', packages=['myapp'], install_requires=[ 'requests>=2.25.1', 'numpy>=1.21.0' ] ) ``` 这样，在使用 `pip install .` 或 `python setup.py install` 安装该包时，所有列出的依赖都会被自动解析和安装[^3]。 #### 2. **支持“开发模式”安装** setuptools 提供了 `develop` 命令，用于将包以“开发模式”安装到当前环境中。这种方式不会复制文件到 `site-packages` 目录，而是创建一个指向当前项目的软链接，从而允许开发者直接在源码目录中进行修改，而无需每次重新安装包。这对于调试和持续开发非常有用。例如： ```bash python setup.py develop ``` 这种机制极大地提高了开发效率，避免了重复执行 `install` 命令带来的麻烦。 #### 3. **生成多种格式的发布包** setuptools 支持生成不同类型的发布包，包括源码包和二进制包。常见的命令如下： - 生成源码包（`.tar.gz`）： ```bash python setup.py sdist ``` - 生成 wheel 包（`.whl`）： ```bash python setup.py bdist_wheel ``` wheel 包是一种预编译的二进制格式，能够显著加快安装速度，并减少用户在安装过程中遇到的编译问题[^3]。 #### 4. **支持包的动态发现** setuptools 提供了 `find_packages()` 函数，可以自动扫描项目目录，发现所有的 Python 包，而不需要手动逐个列出。例如： ```python from setuptools import setup, find_packages setup( name='MyApp', version='1.0', packages=find_packages(), ) ``` 这在项目结构较为复杂或包含多个子包的情况下特别有用，减少了手动维护 `packages` 列表的工作量[^1]。 #### 5. **集成 easy_install 工具** setuptools 引入了 `easy_install` 命令，这是一个早期的包安装工具，能够在没有 `pip` 的情况下自动下载和安装 Python 包。虽然现在 `pip` 已成为主流，但 `easy_install` 仍然是 setuptools 的一部分，用于某些特定场景下的包管理[^5]。 #### 6. **丰富的命令支持** 除了 `install` 和 `develop` 外，setuptools 还支持多种命令，如 `sdist`（生成源码分发包）、`bdist_egg`（生成 `.egg` 格式的二进制包）等。可以通过以下命令查看所有支持的命令： ```bash python setup.py --help-commands ``` 这些命令为开发者提供了灵活的方式来控制包的构建和分发过程[^3]。 ### 总结 setuptools 是 Python 生态系统中不可或缺的一部分，尤其在构建和分发模块化代码方面发挥了重要作用。它不仅简化了依赖管理、提升了开发效率，还支持多种发布格式，满足了不同场景下的需求。尽管现代 Python 开发中越来越多地使用 `pip` 和 `pyproject.toml` 等新工具，但了解和掌握 setuptools 仍然是理解和构建 Python 包的基础。 ---