# Vite

> 分类：`libs/build/` · 档位：**评估** · 更新时间：2026-11-17

## 1. 基本信息

| 项 | 内容 |
|---|---|
| 当前版本 | 当前主版本（见官方 releases） |
| License | MIT |
| 维护方 | Evan You 与 Vite 团队 |
| 仓库 / 文档 | https://github.com/vitejs/vite · https://vite.dev |
| 最近 release | 见官方 releases |

## 2. 一句话定位

前端构建工具：开发期用原生 ESM 做秒启 dev server，生产期用 Rollup（新版为 Rolldown）打包。
它是工具链底座，不绑定框架，产物大小取决于你的应用而不是它自己。

## 3. 体积

| 引入方式 | min | gzip |
|---|---|---|
| 运行时 | 0 KB | 构建工具，不进产物 |
| 应用产物 | 取决于代码与依赖 | 由 rollup 输出决定 |

## 4. 核心 API

```js
// vite.config.js
import { defineConfig } from 'vite';

export default defineConfig({
  base: '/',
  server: { port: 5173, proxy: { '/api': 'http://localhost:3000' } },
  build: { outDir: 'dist', sourcemap: false },
});
```

```bash
vite            # 开发
vite build      # 生产构建
vite preview    # 预览产物
```

## 5. 适用 / 不适用

- **适用**：任何需要打包的前端项目；库开发（library mode）；多页静态站。
- **不适用**：完全无构建的静态页（直接写 HTML/CSS 更省事）。

## 6. 硬缺口与已知坑

- 开发与生产行为有差异（ESM vs 打包），`import.meta.env` 只有 `VITE_` 前缀会注入客户端。
- CommonJS 依赖需要预构建，偶发 interop 问题。
- 部署到子路径必须设 `base`，否则资源 404。
- 大项目依赖预构建与缓存策略需要调优，首启不一定"秒开"。
- 与旧版 Node 不兼容，升级前先看 Node 版本要求。

## 7. 受限环境可用性

| 环境 | 结论 | 说明 |
|---|---|---|
| 无构建 | 不可用 | 本身是构建工具 |
| 静态输出 | 可用 | `dist/` 直接托管 |
| SSR | 需框架集成 | 由元框架提供 |
| 客户端重渲染 | 无关 | 只影响构建 |

## 8. 稳定性评分

| 维度 | 评分 | 依据 |
|---|---|---|
| 维护活跃度 | 5 | 迭代非常活跃 |
| 版本与破坏性变更 | 3 | 大版本升级需改配置 |
| 采用度 | 5 | 事实标准 |
| 体积与按需 | 5 | 零运行时 |
| 生态兼容 | 5 | 插件与框架集成最广 |
| License | 5 | MIT |

## 9. 替代品对比

| 库 | 优势 | 劣势 | 何时选它 |
|---|---|---|---|
| esbuild | 极快、单二进制 | 插件生态与 CSS 处理弱 | 只求速度的构建 |
| webpack | 生态最老、配置能力强 | 慢、配置复杂 | 遗留项目 |
| Parcel | 零配置 | 定制与生态弱 | 小项目 |
| Rspack | webpack 兼容且快 | 生态仍在追赶 | 大型遗留迁移 |
