### 避免直接运行 `setup.py` 的原因 直接运行 `setup.py` 可能会带来一些潜在的风险和不便之处。以下是主要原因： 1. **环境隔离问题** 当直接执行 `setup.py install` 或其他命令时，可能会污染全局 Python 环境，尤其是在未使用虚拟环境中操作的情况下[^1]。这可能导致依赖冲突或其他包管理混乱。 2. **缺乏标准化构建流程** 使用现代工具可以提供更一致的构建体验，而直接调用 `setup.py` 则可能因不同开发者配置而导致不一致性。例如，某些开发者的本地设置可能会影响最终分发版本的行为[^2]。 3. **安全性隐患** 如果项目中的 `setup.py` 文件存在恶意代码或者错误实现，则直接运行它会对系统造成威胁。通过标准工具链（如 PEP 517/PEP 518 定义的方式），可以在沙盒环境下安全地完成安装过程[^3]。 --- ### 推荐使用的工具及其优势 为了克服上述问题并遵循最佳实践，建议采用以下现代化工具来替代直接运行 `setup.py`: #### 1. **`pypa/build`** - 这是一个基于 PEP 517 和 PEP 518 实现的纯 Python 构建前端接口库。 - 主要功能是从源码树中生成 wheel/tarball 而无需显式调用 `setup.py`。 - 提供简单易用的 CLI 工具支持自动化构建工作流。 示例代码如下： ```bash python -m build --sdist --wheel . ``` #### 2. **`pip` with Build Isolation** - Pip 自身已经集成了对 PEP 517 的支持，在安装过程中能够自动处理项目的构建需求。 - 启用了构建隔离机制后，所有必要的依赖项都会被临时安装到独立目录下而不影响现有环境。 命令示例： ```bash pip install . --use-pep517 ``` #### 3. **`flit`** - Flit 是另一个轻量级打包解决方案，专注于简化小型至中型规模项目的发布流程。 - 不再需要维护冗长复杂的 `setup.py` 文件结构；取而代之的是更为直观明了的 TOML 格式元数据描述文件 (`pyproject.toml`)。 示例初始化命令： ```bash flit init ``` #### 4. **`setuptools` Combined With Modern Practices** - 尽管仍然保留了部分传统特性，但最新版 setuptools 开始逐步向兼容 PEP 规范方向演进。 - 结合 pyproject.toml 中定义的具体选项参数，可有效减少人为干预程度从而提升可靠性。 --- ### 总结 综上所述，为了避免潜在风险以及提高效率与稳定性，应当优先考虑利用诸如 PyPA 所提供的官方认可工具代替原始方法来进行软件分发前准备工作。这些新型手段不仅更加贴近当前社区主流趋势而且具备更强健的安全防护措施保障整个生命周期内的正常运转状态^. ```python import subprocess def run_build(): result = subprocess.run(['python', '-m', 'build'], capture_output=True, text=True) if result.returncode != 0: raise Exception(f"Build failed: {result.stderr}") run_build() ```