如何将Python工具打包为PyPI可直接终端执行的Wheel安装包

解决方法 #

核心是在打包配置中声明控制台入口点，pip安装时会自动为你生成跨平台的终端可调用命令包装，无需手动处理脚本路径。

方式1：在pyproject.toml中配置（当前Python打包推荐方案） #

在你的pyproject.toml中添加[project.scripts]配置段：

[project.scripts]
# 左侧为终端调用的命令名，右侧为 包名.模块名:入口函数名
MyTool = "MyTool.MyTool:main"

上述配置对应你的代码结构：MyTool包下的MyTool.py模块中存在入口函数main()，你的工具主逻辑需要放在这个main函数内。

方式2：在setup.cfg中配置 #

如果使用setup.cfg管理配置，添加如下段落：

[options.entry_points]
console_scripts =
    MyTool = MyTool.MyTool:main

验证流程 #

1. 调整完配置后重新执行python -m build生成新的安装包
2. 本地先测试安装：pip install dist/MyTool-xxx.whl（替换为你新生成的whl文件名）
3. 直接在终端输入MyTool即可启动工具，Windows下会自动生成对应exe可执行文件，类Unix系统会生成可调用脚本，全平台都不需要手动加路径前缀。

内容的提问来源于stack exchange，提问作者Andre