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

在 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 

相关文章： 如何彻底删除建站之星生成的Banner？  建站主机选购指南：核心配置优化与品牌推荐方案  如何在万网自助建站中设置域名及备案？  高防服务器：AI智能防御DDoS攻击与数据安全保障  如何通过宝塔面板实现本地网站访问？  如何挑选最适合建站的高性能VPS主机？  制作网站的公司有哪些,做一个公司网站要多少钱？  如何处理“XML格式不正确”错误 常见XML well-formed问题解决方法  建站上传速度慢？如何优化加速网站加载效率？  如何快速启动建站代理加盟业务？  武汉网站设计制作公司,武汉有哪些比较大的同城网站或论坛，就是里面都是武汉人的？  定制建站策划方案_专业建站与网站建设方案一站式指南  建站之星CMS建站配置指南：模板选择与SEO优化技巧  关于BootStrap modal 在IOS9中不能弹出的解决方法(IOS 9 bootstrap modal ios 9 noticework)    潍坊网站制作公司有哪些,潍坊哪家招聘网站好？  如何选择高效便捷的WAP商城建站系统？  如何高效利用亚马逊云主机搭建企业网站？  建站之星logo尺寸如何设置最合适？  jQuery 常见小例汇总  制作网页的网站有哪些,电脑上怎么做网页？  如何获取开源自助建站系统免费下载链接？  定制建站方案优化指南：企业官网开发与建站费用解析  怎么制作网站设计模板图片,有电商商品详情页面的免费模板素材网站推荐吗？  网站微信制作软件,如何制作微信链接？  在线教育网站制作平台,山西立德教育官网？  如何通过服务器快速搭建网站？完整步骤解析  制作企业网站建设方案,怎样建设一个公司网站？  建站之星如何快速解决建站难题？  如何做网站制作流程,*游戏网站怎么搭建？  西安专业网站制作公司有哪些,陕西省建行官方网站？  网站制作的软件有哪些,制作微信公众号除了秀米还有哪些比较好用的平台？  如何在宝塔面板中修改默认建站目录？  网站代码制作软件有哪些,如何生成自己网站的代码？  详解jQuery中基本的动画方法  如何确保西部建站助手FTP传输的安全性？  建站之星导航如何优化提升用户体验？  C++如何使用std::optional？（处理可选值）  网站广告牌制作方法,街上的广告牌，横幅，用PS还是其他软件做的？  微信h5制作网站有哪些,免费微信H5页面制作工具？  建站之星如何配置系统实现高效建站？  广州网站设计制作一条龙,广州巨网网络科技有限公司是干什么的？  交易网站制作流程,我想开通一个网站，注册一个交易网址，需要那些手续？  北京专业网站制作设计师招聘,北京白云观官方网站？  惠州网站建设制作推广,惠州市华视达文化传媒有限公司怎么样？  建站之星如何助力网站排名飙升？揭秘高效技巧  手机网站制作平台,手机靓号代理商怎么制作属于自己的手机靓号网站？  如何破解联通资金短缺导致的基站建设难题？  ,购物网站怎么盈利呢？  网站制作多少钱一个,建一个论坛网站大约需要多少钱？