跳至主要内容

语义化版本控制

由于 Stylelint 作为代码质量工具的性质,我们遵循 语义化版本控制 的特定风格。

任何次要更新都可能报告比先前版本更多的错误。因此,我们建议在 package.json 中使用波浪号 (~),例如 "stylelint": "~7.2.0",以保证构建结果。

补丁版本

旨在不破坏您的 lint 构建

  • 规则中的错误修复,导致 Stylelint 报告更少的错误
  • CLI 或核心(包括格式化程序)的错误修复
  • 文档改进
  • 非用户可见的更改,例如重构代码或修改测试
  • 在发布失败后重新发布(即,发布对任何人都无效的版本)

次要版本

可能会破坏您的 lint 构建

  • 规则中的错误修复,导致 Stylelint 报告更多错误
  • 创建新的规则
  • 现有规则的新选项,默认情况下不会导致 Stylelint 报告更多错误
  • 弃用现有规则
  • 创建新的 CLI 功能
  • 创建新的公共 API 功能
  • 创建新的格式化程序

主要版本

很可能会破坏您的 lint 构建

  • 现有规则的文档化行为更改,导致 Stylelint 默认情况下报告更多错误
  • 删除现有规则
  • 删除现有格式化程序
  • CLI 的一部分以不兼容的方式被删除或更改
  • 公共 API 的一部分以不兼容的方式被删除或更改