release-it项目中预发布版本编号从1开始的配置优化
在软件开发过程中,版本管理是一个至关重要的环节,特别是对于像jQuery这样的大型开源项目。release-it作为一个流行的版本发布工具,近期针对预发布版本(pre-release)的编号方式进行了重要优化,允许开发者从1开始编号,而不是传统的从0开始。
背景与需求
在传统的版本控制实践中,预发布版本(如alpha、beta或rc)通常从0开始编号。例如,第一个beta版本会被标记为2.0.0-beta.0。然而,jQuery项目团队长期以来采用了一种不同的实践方式——他们的预发布版本从1开始编号。这种做法的优势在于更符合人类直觉,当开发者说"这个特性在第二个beta版本中引入"时,对应的版本号就是x.x.x-beta.2,避免了从0开始计数带来的认知偏差。
技术实现
release-it团队在17.5.0版本中实现了这一功能。该功能基于npm的semver(语义化版本控制)规范,该规范本身就支持预发布版本编号的起始值配置。开发者现在可以通过两种方式使用这一特性:
- 命令行参数方式:
release-it major --preRelease=beta --preReleaseBase=1
- 配置文件方式: 在项目的release-it配置文件中添加:
{
"preReleaseBase": "1"
}
实际应用示例
假设当前最新稳定版本是1.3.0,当执行以下命令时:
release-it major --preRelease=beta --preReleaseBase=1
将生成的版本号为2.0.0-beta.1,而不是传统的2.0.0-beta.0。对于后续的beta版本,编号将依次递增为2.0.0-beta.2、2.0.0-beta.3等。
兼容性考虑
值得注意的是,这一配置对稳定版本的发布没有任何影响。当不指定--preRelease参数进行常规发布时,preReleaseBase配置会被自动忽略,确保不会干扰正常的版本发布流程。
总结
release-it的这一改进虽然看似微小,但对于遵循特定版本编号规范的项目团队来说却意义重大。它体现了优秀工具应有的灵活性——既遵循行业标准,又能适应不同团队的特殊需求。对于像jQuery这样的大型项目,这一特性将有助于保持版本编号的一致性,减少团队协作中的认知负担。
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0215
cann-learning-hubCANN 学习中心仓,支持在线互动运行、边学边练,提供教程、示例与优化方案,一站式助力昇腾开发者快速上手。Jupyter Notebook0138
uni-appA cross-platform framework using Vue.jsJavaScript08
GLM-5.2智谱开源 GLM-5.2,这是针对长文本任务的最新旗舰模型。相较于前代产品 GLM-5.1,它在长文本任务处理能力上实现了显著飞跃,并且首次在稳定的 100 万 token 上下文中提供这一能力。Jinja00
SwanLab⚡️SwanLab - an open-source, modern-design AI training tracking and visualization tool. Supports Cloud / Self-hosted use. Integrated with PyTorch / Transformers / LLaMA Factory / veRL/ Swift / Ultralytics / MMEngine / Keras etc.Python00
tiny-universe《大模型白盒子构建指南》:一个全手搓的Tiny-UniverseJupyter Notebook03