How/When 我应该更新版本号吗？

Question

因此，为了获得更多上下文，我使用了这个版本编号系统

版本顺序：MAJOR.MINOR.PATCH

• MAJOR: 主要部分表示 API
中的破损
• MINOR:次要段表示"externally visible"变化
• PATCH:补丁段表示bug修复

我在 github 上有一个项目。所以这是我的问题。

我什么时候更新我的版本号？

• 我上传新更新时是否更新它
• 完成adding/changing一些代码后我会更新它吗

如何递增每个更改？

• 我是否递增每个更改然后上传该版本号
• 当我上传新的更新时，即使我做了几处更改，我是否说只增加 1？ 假设我在上传时制作了 10 个补丁，我只增加 1（基本上是说有 至少 1 个更改）或全部 10 个。因此，如果我在 1.0.0 并进行了 10 次更改，我会在更新的最终版本之前放置 1.0.1 或 1.0.10

我是否重置版本号？

• 例如，我在递增 Minor/Major
后将 Patch 重置为 0
• 我只是从不重置版本号吗

Answer 1

When do I update my version number?

发布版本的合适时间完全由您决定，但您应该对此保持一致。如果您有项目路线图，请考虑将多个相关功能分组为一个里程碑，并在这些功能完成后提升您的次要版本。每个新功能只增加次要版本也是有效的。

最重要的规则是您不要在不影响主版本的情况下对publicAPI引入重大更改。第二个最重要的规则是在不增加某些版本号的情况下不要引入 any 更改。请参阅 https://semver.org/

上的常见问题解答

如果您只是修复错误或进行细微调整，请提高补丁版本。

How do I increment each change?

这取决于您的工作流程，以及您决定如何区分版本。通常，每次只增加一个是有意义的，但您可以在发布 public 构建之前经历多个私有构建。由你决定。

请注意，如果您正在构建一个库或项目托管在 npm 或 crates.io 之类的东西上，您需要在每次更新时更改版本。了解适用于您使用的任何语言的 semver 相关工具。

请注意，语义版本控制确实支持各种标签来识别项目的 testing/beta/alpha 版本，请参阅规则 9 和 10。

Do I reset the version numbers?

是的，当你撞到次要版本时，你应该重置补丁号，当你撞到主要版本时，你应该重置补丁号和次要号。否则，随着项目的进展，您最终会得到大量的版本号。有关如何将优先级分配给版本号的信息，请参阅 semver 规则 11。