### 使用 Python `setup.py` 进行安装的教程 `setup.py` 是 Python 项目中用于分发和安装包的核心脚本。通过它，用户可以轻松地安装、构建和分发 Python 包[^1]。以下内容将详细介绍如何使用 `setup.py` 来完成安装操作。 #### 1. 安装的基本命令 在终端中运行以下命令即可完成项目的安装： ```bash python setup.py install ``` 该命令会根据 `setup.py` 文件中的配置信息，将项目安装到 Python 的站点包目录（site-packages）中[^3]。 #### 2. `setup.py` 文件的基本结构 一个典型的 `setup.py` 文件通常包含以下关键部分： ```python from setuptools import setup, find_packages setup( name='your_package', # 包名称 version='0.1', # 版本号 packages=find_packages(), # 自动查找所有需要打包的模块 install_requires=[ # 依赖项列表 'numpy', 'pandas' ], ) ``` 上述代码定义了包的基本信息，包括名称、版本号、依赖项等[^2]。 #### 3. 开发模式下的安装 如果希望在开发过程中动态修改代码而不重新安装包，可以使用开发模式： ```bash python setup.py develop ``` 此命令会在当前环境中创建一个符号链接，使得对源代码的任何更改都会立即生效。 #### 4. 构建源码分发包 除了直接安装外，还可以生成一个源码分发包供他人下载和安装： ```bash python setup.py sdist ``` 这将在 `dist/` 目录下生成一个 `.tar.gz` 文件，其中包含项目的源代码[^1]。 #### 5. 构建二进制分发包 对于某些需要编译的扩展模块，可以生成二进制分发包： ```bash python setup.py bdist_wheel ``` 这会生成一个 `.whl` 文件，适合快速安装[^1]。 #### 6. 常见问题及解决方法 - **问题**：运行 `python setup.py install` 没有反应。 - **解决方法**：确保已正确安装 `setuptools` 和 `wheel` 模块，并检查 `setup.py` 文件中是否缺少必要的字段[^3]。 ---