Prisma 采用语义化版本控制 (SemVer)

TL;DR

以下是我们正在实施的新规则的简要概述

• 通过采用 SemVer，我们让用户更容易理解哪个版本可能包含重大变更。采用 SemVer 仅仅是我们发布策略的改变，以便与行业实践保持一致并改善开发人员体验。
• 稳定界面（即正式发布 (GA)）中的重大变更将仅在新的主版本中引入。
• 重大变更仍可在次版本中推出，但仅限于默认不激活的选择性预览和抢先体验功能（例如，通过预览功能标志或特定的选择性选项或新的 CLI 命令）。
• 在次版本中发布的需要选择性的重大变更（即预览和抢先体验）将仅在新的主版本中提升为正式发布（无需选择性）。

您可以在我们的文档中的发布和成熟度级别部分阅读更多详细信息。

Prisma 版本采用 SemVer

语义化版本控制 (SemVer) 是一种常规的发布策略，对用户何时可以预期软件版本中的重大变更有明确的规则。

虽然我们已经遵循了 Prisma 版本的 3 位 SemVer 表示法，但我们尚未完全遵循实际的 SemVer 语义。这意味着我们有时会在次版本增量时发布重大变更。

未来，次版本增量中的重大变更将始终是选择性的。对 Prisma ORM 稳定开发界面的任何重大变更都只会在主版本增量中发生。

目前，用户很难理解哪个版本可能包含或不包含重大变更。当通过多个版本升级时，例如从2.13.0升级到2.26.0，您必须阅读每个中间版本的发行说明，以确定哪些重大变更会影响您——这使得处理重大变更变得困难。

这对您意味着什么？

本质上，新的发布策略不会改变您使用 Prisma 的方式以及 Prisma 的持续演进。我们只是让您更容易理解哪个版本可能包含重大变更。

Prisma 将继续在发行说明中记录即将到来的重大变更的确切细节。此外，我们将提供升级指南，以帮助主版本之间的升级路径。

行业中的许多包管理器和依赖自动化工具都是考虑到 SemVer 而设计的，例如Renovate和Dependabot。它们通过自动化部分依赖升级过程、创建包含相关发布变更的拉取请求以及自动合并非重大变更来节省您的时间。

我们为何采用 SemVer 语义

更新依赖项可能是一个耗时的过程——尤其是在具有许多依赖项的项目中。遵守 SemVer 应该能改善您的升级体验，因为重大变更变得可预测且可见。

SemVer 是一个广泛使用的行业标准，尤其是在 Node.js 生态系统中。

随着越来越多的开发人员和公司采用 Prisma 并获得有关我们发布策略的有用反馈，我们决定调整我们的发布策略并在未来全面采用 SemVer。

Prisma 即将发布的一个版本将包含重大变更

Prisma 即将发布的版本之一将包含重大变更。根据我们的新发布策略，主版本号将增加，Prisma 的新版本将因此为3.x.x。

您可以在文档中阅读有关我们发布策略的更多信息。