生成.whl
文件主要有以下两种方式,适用于不同场景:
一、使用pip
命令行工具生成
-
安装依赖
确保已安装
wheel
包(可通过pip install wheel
安装)。 -
运行打包命令
在项目根目录下执行以下命令:
pip wheel --wheel-dir dist
--wheel-dir
指定输出目录(默认为当前目录)。
-
验证生成结果
打开
dist
目录,查看是否生成.whl
文件(如your_package-1.0.0-py3-none-any.whl
)。
二、手动创建.whl
文件
-
准备项目结构
-
确保项目包含
setup.py
文件,定义模块和依赖(如ext_modules
)。 -
使用
__init__.py
使目录可被识别为Python包。
-
-
运行打包脚本
在命令行中执行:
python setup.py bdist_wheel
该命令会在
dist
目录生成.whl
文件。 -
优化文件结构(可选)
- 修改
setup.py
或项目路径,使生成的.whl
文件更易读(如调整包名或目录层级)。
- 修改
三、注意事项
-
依赖管理 :建议将项目依赖写入
requirements.txt
,便于其他用户安装。 -
版本兼容 :生成的
.whl
文件需与目标Python版本匹配(如py3-none-any
表示兼容所有平台)。
通过以上方法,可高效生成并分享Python项目包。