Python模块打包进阶教程_setup.py与wheel发布实战

冬枫小哥_4941

冬枫小哥_4941

2026-01-02

691人浏览

原创

发布Python模块到PyPI需正确配置setup.py或pyproject.toml,用python -m build构建wheel,本地验证后通过twine upload上传;版本号必须递增,不可覆盖。

python模块打包进阶教程_setup.py与wheel发布实战

想把 Python 模块打包发布到 PyPI,让别人用 pip install 就能装?关键不在写代码,而在写对 setup.py(或现代替代方案),再正确构建 wheel 并上传。跳过这步,再好的库也走不出本地目录。

setup.py 不是可有可无的配置文件

它定义了包名、版本、依赖、入口点、数据文件等核心元信息,pip 安装时全靠它解析。哪怕只有一行 print("hello") 的脚本,想被 pip 识别为可安装包,也必须有合法的 setup.py。

  • 必须调用 setuptools.setup(),不能只写变量
  • name 要全局唯一(PyPI 上已存在会上传失败),建议加前缀如 myorg-mypkg
  • packages 别手动列目录,用 find_packages() 自动发现(需先 from setuptools import find_packages)
  • install_requires 写运行时依赖,格式如 ["requests>=2.25.0", "click"];开发依赖放 extras_require 里
  • 如果含非 Python 文件(如 config.json、templates/),用 package_data 或 MANIFEST.in 显式声明,否则不会打进 wheel

用 python -m build 替代老旧的 python setup.py sdist bdist_wheel

官方已弃用直接调用 setup.py 构建命令。推荐用 build 工具——轻量、标准、兼容 PEP 517。

  • 先装: pip install build
  • 在项目根目录执行:python -m build,自动构建 source distribution(.tar.gz)和 wheel(.whl)
  • 生成物在 dist/ 目录下,wheel 文件名含平台标记(如 mylib-0.1.0-py3-none-any.whl 表示纯 Python、兼容所有 Python 3 版本)
  • 构建前确保 pyproject.toml 存在(哪怕只有最基本的构建后端声明),否则 build 可能回退到旧逻辑

上传前:测试 wheel 是否真正可用

别急着上传 PyPI。本地验证能避免“上传成功但用户装不上”的尴尬。

windows-auto
windows-auto

Windows 桌面自动化技能,支持鼠标控制(移动/点击/拖拽/滚轮/截图)、键盘输入(文字输入/按键/组合键)、窗口管理(查找/聚焦/最大化/最小化/关闭/移动)、截图并发送文件。提供两种截图方式:Python pyautogui 截图(集成在自动化流程中)和 PowerShell + .NET 零依赖截图(支持区域截图和多显示器)。当用户需要自动化 Windows 桌面操作、控制鼠标键盘、管理窗口、执行 GUI 自动化任务、截图发送文件时使用。

下载
  • 新建虚拟环境:python -m venv testenv && source testenv/bin/activate(Windows 用 testenv\Scripts\activate)
  • 用本地 wheel 安装:pip install dist/mylib-0.1.0-py3-none-any.whl
  • 进 Python,尝试 import mylib,并运行关键函数或 CLI 入口点
  • 检查 pip show mylib 输出:版本、依赖、Location 是否符合预期
  • 若报 ModuleNotFoundError,大概率是 packages 或 package_data 漏配;若 CLI 命令找不到,检查 entry_points 中的 console_scripts 键值是否拼写正确

上传到 PyPI:twine 是唯一推荐方式

不用 setup.py upload(已移除),也不用网页手动上传。twine 安全、稳定、支持两次上传校验。

  • 安装:pip install twine
  • 注册 PyPI 账号(https://www.php.cn/link/1f6325d1b1080e812e7b713ae61f4ebc),获取 API token(Settings → API tokens → Create new token)
  • 上传:twine upload dist/*,提示输入用户名时填 __token__,密码粘贴 token 字符串
  • 上传成功后,访问 https://pypi.org/project/your-package-name/ 即可查看页面,他人就能 pip install your-package-name 了
  • 后续更新只需改 setup.py 中的 version,重新 build 和 upload —— PyPI 不允许覆盖同版本,所以版本号必须递增

不复杂但容易忽略:一个干净的 setup.py 或 pyproject.toml,一次本地 wheel 验证,一次 twine 上传,你的模块就真正“发布”了。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2255

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

3602

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1196

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4159

7

pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

2023.10.09

3370

5

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

2024.12.20

7663

6

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

2024.12.23

9342

11

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

2025.07.23

4867

16

python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end='\n', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.27

3240

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程