PyPI 是 Python 软件包的索引与发布平台,pip 则负责从索引获取并安装软件包。理解这一区别,有助于初学者找到需要的库,也能避免把软件包目录和安装工具混为一谈。
PyPI 是什么意思?
PyPI 是 Python Package Index 的缩写,中文常称 Python 软件包索引。开发者可以在 PyPI 查找项目,查看项目说明、版本和发行文件等信息。PyPI 与 Python 编程语言)相关,但不是 Python 自带的标准库目录。PyPI 官网提供项目索引和相关信息,详见PyPI 官方网站。

这里的“软件包”通常包含可供其他 Python 项目使用的代码和相关元数据。第三方库常以软件包形式发布,项目页面则集中展示名称、用途说明、版本和发行文件。本文介绍 PyPI 的基本概念,不涉及某个库的具体用法。
PyPI 能做什么,不能保证什么?
PyPI 帮助用户发现和获取软件包,但平台收录项目并不表示每个软件包都经过安全审计。PyPI 的安全说明也提醒用户留意软件包风险。页面仍可访问、项目近期有更新,或下载量较高,都不能单独证明软件包安全。
PyPI 和 pip 分别负责什么?
| 对比项 | PyPI | pip |
|---|---|---|
| 角色 | 软件包索引与分发平台 | 软件包安装与管理工具 |
| 主要用途 | 展示项目资料和发行文件 | 从软件包索引获取并安装软件包 |
| 常见误解 | 以为 PyPI 会自行安装软件包 | 以为 pip 是软件包仓库 |
pip 是 Python 软件包安装工具,详情可查阅pip 官方文档。如果你想了解日常操作,可以阅读站内的 Python pip 使用指南;还没有安装 pip 的读者,也可查看安装 pip 的方法。
如何在 PyPI 搜索包
查找软件包时,可以按以下步骤操作:
- 打开 PyPI 官网。
- 在搜索框输入项目名称或相关词语。
- 查看搜索结果,核对候选项目的名称和说明。
- 进入项目页面,检查版本、维护者、发行文件和相关链接。
名称相似不代表项目相同。若暂时找不到目标包,先检查拼写、连字符和下划线,再确认项目是否使用了另一个正式名称。国内访问 PyPI 较慢时,可参考站内的镜像源说明。本文不展开 PyPI 镜像配置。
怎样读懂 PyPI 项目页面
页面信息可以帮助你了解项目,但单项信息通常不足以验证项目身份、质量或安全性。
| 页面信息 | 可以了解什么 | 不能单独证明什么 |
|---|---|---|
| 包名与项目说明 | 项目自述的用途和目标 | 项目身份或质量已得到核实 |
| 版本与更新时间 | 已发布的版本及发布时间 | 更新频繁就代表维护可靠 |
| 下载量(若页面或统计工具提供) | 一段时间内的下载情况 | 下载者都在使用,或软件包安全 |
| 项目主页与维护者 | 项目提供的外部入口和维护者资料 | 链接及身份必然真实可信 |
| 依赖项 | 项目声明需要的其他软件包 | 依赖没有风险,或适用于所有环境 |
| 发行文件 | 可获取的文件类型和版本 | 文件内容已经过安全审计 |
常见的发行文件包括 wheel 和 sdist。wheel 是预先构建的软件包格式;sdist 是源代码发行包。Python Packaging Authority 的打包指南介绍了这些格式及相关元数据。不同项目页面展示的信息可能不同,判断时应结合项目实际资料和官方文档。
选择 Python 包前,先核对五项信息
我会先检查以下内容,再决定是否进一步了解或安装项目:
- **核对包名和用途:**名称是否符合预期?项目说明是否对应实际需求?
- **阅读项目说明:**确认功能、适用范围和使用限制。
- **查看维护者与主页:**核对外部主页是否指向同一项目,并检查维护者资料是否可查。
- **对照版本和发行文件:**确认版本及文件类型符合项目和运行环境的要求。
- **查看依赖项:**留意依赖是否符合用途,并参考官方安全建议。
这份清单只能用于初步核对,并非安全认证。近期更新或较高下载量也不能作为安全保证。更多 Python 入门资料可从 Python下载继续查找。
PyPI 常见问题
PyPI 是什么的缩写?
PyPI 是 Python Package Index 的缩写,中文常称 Python 软件包索引。
PyPI 是 Python 的官方软件包索引吗?
PyPI 是 Python 生态中常用的软件包索引与分发平台,提供项目页面和发行文件。但这不代表每个包都经过安全审计。
PyPI 上下载量高,是否说明软件包安全?
不能。下载量只能作为使用情况的线索,无法证明软件包安全、维护质量良好,或适合你的项目。
如何查看项目依赖?
先查看项目页面和说明中的依赖信息。如果页面没有列清楚,可以查阅项目主页、发行说明或元数据。不同项目展示依赖信息的方式可能不同。
如何创建并发布 PyPI 软件包?
本文聚焦于查找软件包和阅读项目页面,不介绍打包或发布流程。准备发布软件包时,可查阅 Python Packaging Authority 打包指南中的相关说明。
来源
- PyPI 官方网站与项目索引,Python Packaging Authority
- PyPI 安全说明,Python Packaging Authority
- pip 官方文档,Python Packaging Authority
- Python 打包用户指南,Python Packaging Authority
Related: pip 是什么, 国内访问 PyPI 慢的换源办法