发布

Vite 的发布遵循语义化版本控制 (Semantic Versioning)。你可以在 Vite npm 包页面 查看 Vite 的最新稳定版本。

过去版本的完整变更日志可在 GitHub 上查看。

发布周期

Vite 没有固定的发布周期。

• 补丁 (Patch) 版本根据需要发布（通常每周一次）。
• 次要 (Minor) 版本通常包含新功能，并根据需要发布。次要版本发布前总会经历一个 beta 预发布阶段（通常每两个月一次）。
• 主要 (Major) 版本通常与 Node.js 生命周期 (EOL) 保持一致，并会提前预告。这些版本在发布前会经历与生态系统的长期讨论，并包含 alpha 和 beta 预发布阶段（通常每年一次）。

受支持的版本

总之，当前受支持的 Vite 版本如下：

• 定期为 vite@8.0 发布补丁。
• 重要修复和安全补丁会被反向移植到 vite@7.3。
• 安全补丁也会被反向移植到 vite@6.4。
• 在此之前的所有版本均已停止支持。用户应升级以获取更新。

如果你正在使用 Vite，该版本不受支持。

受支持的版本范围由以下规则自动确定：

• 当前次要版本：获取常规修复。
• 上一主要版本（仅限其最新次要版本）和上一次要版本：获取重要修复和安全补丁。
• 倒数第二主要版本（仅限其最新次要版本）和倒数第二次要版本：获取安全补丁。
• 在此之前的所有版本均已停止支持。

我们建议定期更新 Vite。在更新每个主要版本时，请查阅迁移指南。Vite 团队与生态系统中的主要项目密切合作，以确保新版本的质量。我们在发布前会通过 vite-ecosystem-ci 项目测试新版 Vite。大多数使用 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 讨论区。