知海

版本发布说明

vite-main发布与更新日志

版本发布说明

Vite 的版本发布遵循语义化版本规范。你可以在 Vite npm 包页面 查看最新的稳定版本。

过往所有版本的完整更新日志请参见 GitHub

发布周期

Vite 没有固定的发布周期。

  • 补丁(Patch) 版本按需发布(通常每周一次)。
  • 次要(Minor) 版本始终包含新功能,并按需发布。次要版本在正式发布前总是会有一个测试版(Beta)预发布阶段(通常每两个月一次)。
  • 主要(Major) 版本通常与 Node.js 的 EOL(生命周期结束)时间表保持一致,并会提前公告。这些版本将与生态社区进行长期讨论,并经历 Alpha 和 Beta 两个预发布阶段(通常每年一次)。

支持的版本

简而言之,当前受支持的 Vite 版本如下:


支持的版本范围由以下规则自动决定:

  • 当前次要版本 会获得常规修复。
  • 上一个主要版本(仅限于其最新的次要版本)和上一个次要版本 会获得重要修复和安全补丁。
  • 倒数第二个主要版本(仅限于其最新的次要版本)和倒数第二个次要版本 仅会获得安全补丁。
  • 以上范围之外的所有版本均不再受支持。

我们建议你定期更新 Vite。在升级到每个主要版本时,请查阅相关的迁移指南。Vite 团队与生态中的主要项目紧密合作,以确保新版本的质量。我们在发布新版本之前,会通过 vite-ecosystem-ci 项目对它们进行测试。大多数使用 Vite 的项目应该能够在发布后快速提供支持或迁移到新版本。

语义化版本的边界情况

TypeScript 类型定义

我们可能会在次要版本之间对 TypeScript 类型定义进行不兼容的更改。原因如下:

  • 有时 TypeScript 本身会在其次要版本之间引入不兼容的更改,我们可能需要调整类型以支持更新版本的 TypeScript。
  • 偶尔我们可能需要采用仅在更新版本的 TypeScript 中才可用的特性,从而提高了对 TypeScript 最低版本的要求。
  • 如果你正在使用 TypeScript,可以使用一个锁定当前次要版本的 semver 范围,并在 Vite 发布新的次要版本时手动升级。

Node.js 非 LTS 版本

非 LTS 的 Node.js 版本(奇数版本)不包含在 Vite 的 CI 测试中,但在其 EOL 之前,它们应该仍然可以正常使用。

预发布

次要版本通常会经历数量不定的 Beta 发布阶段。主要版本则会经历一个 Alpha 阶段和一个 Beta 阶段。

预发布版本允许生态中的早期采用者和维护者进行集成和稳定性测试,并提供反馈。请勿在生产环境中使用预发布版本。所有预发布版本均被视为不稳定的,并且可能在发布之间包含破坏性更改。使用预发布版本时,请务必锁定到精确的版本。

弃用

我们会在次要版本中定期弃用那些已被更优替代方案取代的功能。已弃用的功能将继续工作,但会输出类型或日志警告。它们在进入弃用状态后,会在下一个主要版本中被移除。每个主要版本的迁移指南都会列出这些移除项,并记录相应的升级路径。

实验性功能

某些功能在 Vite 稳定版本中发布时会被标记为实验性。实验性功能使我们能够收集真实世界中的经验,以影响其最终设计。其目的是让用户通过在生产环境中测试它们来提供反馈。实验性功能本身被认为是不稳定的,并且只应在可控的方式下使用。这些功能可能会在次要版本之间发生变化,因此用户必须固定其 Vite 版本才能依赖它们。我们将会为每个实验性功能创建 GitHub 讨论

帮助我们改进文档

发现翻译问题或内容错误?请告诉我们。