可以同时发布开发版和稳定版：版本管理最佳实践

在 python 包开发中，你完全可以在推进 `1.0.0.dev1` 等预发布版本的同时，继续发布 `0.8.5` 或 `0.9.0` 等稳定版本；pip 及主流工具（如 poetry、pipenv）默认忽略预发布版本，优先安装最新稳定版。

这是语义化版本（SemVer）与现代 Python 工具链协同工作的标准实践。核心原理在于：预发布版本（如 1.0.0.dev1、1.0.0a1、1.0.0rc2）在版本比较中被明确标记为“非稳定”，因此不会干扰稳定分支的迭代节奏。

例如，假设你的 PyPI 仓库中存在以下版本：

• 0.8.4（stable）
• 0.8.5（stable，刚发布）
• 0.9.0（stable，计划中）
• 1.0.0.dev1（pre-release，位于 main 或 dev 分支）

当用户执行 pip install mypackage 时，pip 默认启用 --pre 标志的反向行为——即 不包含 --pre 时，自动排除所有含 dev/a/b/rc 等标识的版本。因此，它将解析出最高稳定版本 0.9.0（若已发布），而非 1.0.0.dev1。

✅ 正确操作示例（setup.py 或 pyproject.toml 中）：

# pyproject.toml
[project]
name = "mypackage"
version = "0.8.5"  # 发布稳定版时直接更新此处

# 发布 0.8.5（稳定）
twine upload dist/mypackage-0.8.5-py3-none-any.whl

# 同时，1.0.0.dev1 可独立发布（需显式指定 --pre）
twine upload dist/mypackage-1.0.0.dev1-py3-none-any.whl

⚠️ 注意事项：

• 若需安装开发版，用户必须显式加 --pre：pip install --pre mypackage
• 使用 Poetry 时，poetry add mypackage 默认不拉取预发布版；如需，需写 poetry add mypackage@^1.0.0-dev
• 确保 CI/CD 流水线对 dev 版本打标签（如 git tag 1.0.0.dev1）并跳过自动部署到生产环境的步骤
• 推荐在 README.md 中清晰说明版本策略，例如：“稳定版见 v0.x 分支；1.0.0 开发进展请关注 dev 分支及 1.0.0.dev* 预发布包”

总结：并行维护多个稳定小版本（0.8.x → 0.9.x）与一个长期开发的大版本（1.0.0）不仅可行，更是提升项目可维护性与用户信任度的关键策略——它保障了现有用户持续获得安全修复与小幅增强，同时为新特性提供充分的灰度验证周期。

# python  # git  # 工具  # ai  # win 

相关文章： 如何用景安虚拟主机手机版绑定域名建站？  建站主机选择指南：服务器配置与SEO优化实战技巧  如何在IIS服务器上快速部署高效网站？  如何实现建站之星域名转发设置？  宁波免费建站如何选择可靠模板与平台？  如何在Golang中处理模块冲突_解决依赖版本不兼容问题  正规网站制作公司有哪些,目前国内哪家网页网站制作设计公司比较专业靠谱？口碑好？  如何在万网ECS上快速搭建专属网站？  如何注册花生壳免费域名并搭建个人网站？  在线ppt制作网站有哪些,请推荐几个好的课件下载的网站？  如何通过虚拟主机快速搭建个人网站？  已有域名如何快速搭建专属网站？  手机网站制作平台,手机靓号代理商怎么制作属于自己的手机靓号网站？  Python文件管理规范_工程实践说明【指导】  开心动漫网站制作软件下载,十分开心动画为何停播？  C#如何序列化对象为XML XmlSerializer用法  浙江网站制作公司有哪些,浙江栢塑信息技术有限公司定制网站做的怎么样？  如何用搬瓦工VPS快速搭建个人网站？  定制建站价位费用解析与套餐推荐全攻略  公司门户网站制作公司有哪些,怎样使用wordpress制作一个企业网站？  如何制作公司的网站链接,公司想做一个网站，一般需要花多少钱？  如何快速搭建高效可靠的建站解决方案？  高防服务器租用如何选择配置与防御等级？  建站中国必看指南：CMS建站系统+手机网站搭建核心技巧解析  定制建站平台哪家好？企业官网搭建与快速建站方案推荐  如何设置并定期更换建站之星安全管理员密码？  如何在橙子建站中快速调整背景颜色？  如何在自有机房高效搭建专业网站？  如何在七牛云存储上搭建网站并设置自定义域名？  学生网站制作软件,一个12岁的学生写小说，应该去什么样的网站？  如何在阿里云香港服务器快速搭建网站？  深圳防火门网站制作公司,深圳中天明防火门怎么编码？  如何用好域名打造高点击率的自主建站？  盐城做公司网站,江苏电子版退休证办理流程？  网站企业制作流程,用什么语言做企业网站比较好？  建站之星代理如何优化在线客服效率？  香港代理服务器配置指南：高匿IP选择、跨境加速与SEO优化技巧  长春网站建设制作公司,长春的网络公司怎么样主要是能做网站的？  建站之星如何实现五合一智能建站与营销推广？  详解免费开源的DotNet二维码操作组件ThoughtWorks.QRCode（.NET组件介绍之四）  jQuery 常见小例汇总  股票网站制作软件,网上股票怎么开户？  建设网站制作价格,怎样建立自己的公司网站？  如何在Golang中使用replace替换模块_指定本地或远程路径  济南网站建设制作公司,室内设计网站一般都有哪些功能？  如何零基础开发自助建站系统？完整教程解析  公司网站建设制作费用,想建设一个属于自己的企业网站，该如何去做？  C++时间戳转换成日期时间的步骤和示例代码  如何通过免费商城建站系统源码自定义网站主题与功能？  建站之星备案是否影响网站上线时间？