内容提要
PyPI开发者文档已从warehouse.pypa.io迁移至dev.pypi.org,旧链接自动重定向,使PyPI所有站点统一在pypi.org域名下。新站点内容不变,仍面向Warehouse代码库开发者,提供本地开发环境搭建指南、架构概览及XML-RPC API等参考;用户使用文档仍在docs.pypi.org。用户无需操作,建议更新书签和外部链接。
延伸解读
域名统一背后的信息架构调整
PyPI将开发者文档从warehouse.pypa.io迁移至dev.pypi.org,核心动机是让所有PyPI站点统一在pypi.org域名下。此前用户文档在docs.pypi.org、博客在blog.pypi.org,开发者文档是唯一例外。这种统一不仅便于用户识别站点归属,也降低了因域名分散导致的混淆,是项目成熟后对信息架构的一次梳理。
两类文档的受众边界更清晰
迁移后,dev.pypi.org专门面向Warehouse代码库的开发者,内容涵盖本地开发环境搭建、架构概览及XML-RPC API等参考;而普通用户所需的包发布、Trusted Publishing、JSON API等帮助仍在docs.pypi.org。这种划分让两类读者能更快找到对应文档,避免在错误站点中搜索。
旧链接自动重定向,但建议主动更新
所有warehouse.pypa.io的旧链接会自动重定向到dev.pypi.org的对应页面,用户无需任何操作。不过,若你在书签或项目中引用了开发者文档,官方建议将链接更新为新域名。虽然旧链接仍可用,但主动更新能减少未来重定向依赖,也便于分享时指向准确地址。
Q&A
PyPI开发者文档的新地址是什么?
PyPI开发者文档的新地址是dev.pypi.org。
旧的warehouse.pypa.io链接还能用吗?
可以,旧链接会自动重定向到dev.pypi.org上的对应页面。
为什么PyPI要把开发者文档迁移到dev.pypi.org?
因为PyPI的其他站点(用户文档docs.pypi.org和博客blog.pypi.org)都已位于pypi.org域名下,开发者文档是唯一例外,迁移后所有PyPI站点统一在一个域名下。
dev.pypi.org上提供哪些内容?
dev.pypi.org提供与warehouse.pypa.io相同的内容,面向Warehouse代码库的开发者,包括本地开发环境搭建指南、架构概览以及XML-RPC API等参考材料。
PyPI用户文档在哪里?
PyPI用户文档仍在docs.pypi.org,包括发布包、Trusted Publishing、JSON API等使用帮助。
开发者文档迁移后,我需要做什么吗?
不需要。旧链接会自动重定向。如果你有书签或从自己的项目链接到开发者文档,建议更新为dev.pypi.org,但现有链接仍会正常工作并重定向。