Python打包命令全攻略

骆驼爱记录2026-01-18 10:13

Python打包常用命令

pip install setuptools wheel

安装打包基础工具，setuptools用于构建包，wheel用于生成二进制分发格式。

python setup.py sdist

创建源代码分发包（.tar.gz或.zip格式），包含项目源码和元数据。

python setup.py bdist_wheel

构建wheel格式的分发包（.whl文件），适合跨平台快速安装。

现代打包工具命令

pip install build

安装最新的Python构建工具，替代直接调用setup.py的方式。

python -m build

使用现代构建系统生成sdist和wheel包，自动处理依赖和隔离环境。

pip install twine

安装上传工具，用于将包发布到PyPI或其他仓库。

twine upload dist/*

上传打包文件到PyPI，需提前配置账号认证。

虚拟环境相关命令

python -m venv venv

创建隔离的虚拟环境，避免打包时污染系统Python环境。

source venv/bin/activate

激活虚拟环境（Linux/macOS），确保打包依赖独立。

venv\Scripts\activate

激活虚拟环境（Windows）。

依赖管理命令

pip freeze > requirements.txt

生成当前环境的所有依赖清单文件。

pip install -r requirements.txt

根据requirements.txt安装项目依赖。

python setup.py develop

以开发模式安装包，允许实时修改代码无需重新安装。

高级打包配置

在setup.py中定义包信息：

python 复制代码

from setuptools import setup

setup(
    name="your_package",
    version="0.1",
    packages=["your_module"],
    install_requires=["dependency>=1.0"]
)

使用pyproject.toml替代setup.py（PEP 518标准）：

toml 复制代码

[build-system]
requires = ["setuptools>=42", "wheel"]
build-backend = "setuptools.build_meta"

其他实用命令

pip show <package>

查看已安装包的详细信息，包括安装路径和依赖。

pip list --outdated

列出所有可升级的已安装包。

python -m pip install --upgrade pip

升级pip到最新版本。