入门指南

概述

Vite（法语单词，意为“快速”，发音为 /viːt/，类似 "veet"）是一个构建工具，旨在为现代 Web 项目提供更快、更轻量的开发体验。它由两个主要部分组成：

一个开发服务器，在原生 ES 模块之上提供丰富的功能增强，例如极快的热模块替换 (HMR)。
一个构建命令，使用 Rolldown 打包你的代码，预配置为输出高度优化的生产静态资源。

Vite 采用约定式风格，开箱即用。在功能指南中阅读相关内容。通过插件可以支持框架或与其他工具集成。配置部分解释了如何根据需要将 Vite 适配到你的项目。

Vite 还可通过其插件 API 和 JavaScript API 高度扩展，并支持完整类型。

你可以在为什么选择 Vite 部分了解更多关于项目背后的理由。

通过 Scrimba 上的互动教程学习 Vite

。

浏览器支持

在开发期间，Vite 假设使用的是现代浏览器。这意味着浏览器支持大多数最新的 JavaScript 和 CSS 特性。因此，Vite 将 esnext 设为转换目标。这会阻止语法降级，使 Vite 能够尽可能贴近原始源代码地提供模块。Vite 会注入一些运行时代码，以使开发服务器正常工作。此代码使用了每个主版本发布时 Baseline 中“新近可用”的特性（本版本对应 2026-01-01）。

对于生产构建，Vite 默认以每个主版本固定日期时 Baseline 中“广泛可用”的浏览器版本为目标。对于本版本，这对应于大约在 2023 年年中发布的浏览器版本。可以通过配置降低目标版本。此外，还可以通过官方的 @vitejs/plugin-legacy 支持旧版浏览器。有关更多详细信息，请参阅面向生产环境构建部分。

在线尝试 Vite

你可以在 StackBlitz 上在线尝试 Vite。它直接在浏览器中运行基于 Vite 的构建设置，因此几乎与本地设置相同，但不需要在你的机器上安装任何东西。你可以导航到 vite.new/{template} 来选择要使用的框架。

支持的模板预设如下：

JavaScript	TypeScript
vanilla	vanilla-ts
vue	vue-ts
react	react-ts
preact	preact-ts
lit	lit-ts
svelte	svelte-ts
solid	solid-ts
qwik	qwik-ts

搭建你的第一个 Vite 项目

然后按照提示操作！

在 Scrimba 上观看互动课程

兼容性说明

Vite 需要 Node.js 版本 20.19+ 或 22.12+。但是，某些模板需要更高的 Node.js 版本才能工作，如果你的包管理器发出警告，请升级。

使用命令行选项运行 create vite

你也可以通过额外的命令行选项直接指定项目名称和想要使用的模板。例如，要搭建一个 Vite + Vue 项目，运行：

bash

# npm 7+，需要额外的双破折号：
$ npm create vite@latest my-vue-app -- --template vue

bash

$ yarn create vite my-vue-app --template vue

bash

$ pnpm create vite my-vue-app --template vue

bash

$ bun create vite my-vue-app --template vue

bash

$ deno init --npm vite my-vue-app --template vue

有关每个受支持模板的更多详细信息，请参阅 create-vite：vanilla、vanilla-ts、vue、vue-ts、react、react-compiler、react-ts、react-compiler-ts、preact、preact-ts、lit、lit-ts、svelte、svelte-ts、solid、solid-ts、qwik、qwik-ts。

你可以使用 . 作为项目名称，在当前目录中搭建。

要创建没有交互提示的项目，可以使用 --no-interactive 标志。

社区模板

create-vite 是一个工具，用于从流行框架的基础模板快速启动项目。查看 Awesome Vite 获取社区维护的模板，其中包含其他工具或针对不同的框架。

对于位于 https://github.com/user/project 的模板，你可以使用 https://github.stackblitz.com/user/project 在线尝试（在项目的 URL 中 github 后添加 .stackblitz）。

你也可以使用像 tiged 这样的工具，使用其中一个模板搭建你的项目。假设项目在 GitHub 上并使用 main 作为默认分支，你可以使用以下命令创建本地副本：

bash

npx tiged user/project my-project
cd my-project

npm install
npm run dev

手动安装

在你的项目中，你可以使用以下命令安装 vite CLI：

并创建一个如下所示的 index.html 文件：

html

<p>你好 Vite！</p>

然后在终端中运行相应的 CLI 命令：

index.html 将在 http://localhost:5173 上提供服务。

`index.html` 和项目根目录

你可能注意到的一件事是，在 Vite 项目中，index.html 位于中心位置，而不是藏在 public 里面。这是故意的：在开发期间，Vite 是一个服务器，index.html 是你应用程序的入口点。

Vite 将 index.html 视为源代码和模块图的一部分。它解析引用你 JavaScript 源代码的 <script type="module" src="...">。即使是内联的 <script type="module"> 和通过 <link href> 引用的 CSS 也能享受 Vite 特有的功能。此外，index.html 内部的 URL 会自动重新基准化，因此不需要特殊的 %PUBLIC_URL% 占位符。

类似于静态 HTTP 服务器，Vite 有一个“根目录”的概念，你的文件从这里提供服务。在文档的其余部分，你将看到它被引用为 <root>。源代码中的绝对 URL 将使用项目根目录作为基础进行解析，因此你可以像使用普通静态文件服务器一样编写代码（除了功能更强大！）。Vite 还能够处理解析到根目录外文件系统位置的依赖项，这使得它甚至可以在基于 monorepo 的设置中使用。

Vite 还支持具有多个 .html 入口点的多页应用。

指定替代根目录

运行 vite 会使用当前工作目录作为根目录启动开发服务器。你可以使用 vite serve some/sub/dir 指定替代根目录。
请注意，Vite 还在项目根目录内解析其配置文件（即 vite.config.js），所以如果根目录更改，你需要移动它。

命令行界面

在安装了 Vite 的项目中，你可以在 npm 脚本中使用 vite 二进制文件，或者直接使用 npx vite 运行它。以下是 scaffolded Vite 项目中的默认 npm 脚本：

package.json

json

{
  "scripts": {
    "dev": "vite", // 启动开发服务器，别名：`vite dev`, `vite serve`
    "build": "vite build", // 生产构建
    "preview": "vite preview" // 本地预览生产构建
  }
}

你可以指定额外的 CLI 选项，如 --port 或 --open。如需完整的 CLI 选项列表，请在你的项目中运行 npx vite --help。

详细了解命令行界面。

使用未发布的提交

如果你迫不及待想测试最新功能而等待新版本发布，你可以使用 https://pkg.pr.new 安装 Vite 的特定提交：

npmYarnpnpmBun

bash

$ npm install -D https://pkg.pr.new/vite@SHA

bash

$ yarn add -D https://pkg.pr.new/vite@SHA

bash

$ pnpm add -D https://pkg.pr.new/vite@SHA

bash

$ bun add -D https://pkg.pr.new/vite@SHA

将 SHA 替换为 Vite 的提交 SHA 中的任意一个。请注意，只有最近一个月内的提交才有效，因为旧的提交发布会被清除。

或者，你也可以将 vite 仓库克隆到本地机器，然后自行构建和链接它（需要 pnpm）：

bash

git clone https://github.com/vitejs/vite.git
cd vite
pnpm install
cd packages/vite
pnpm run build
pnpm link # 在此步骤中使用你偏好的包管理器

然后进入你的基于 Vite 的项目并运行 pnpm link vite（或使用你用来全局链接 vite 的包管理器）。现在重启开发服务器以体验最新前沿功能！

要了解有关 Vite 如何以及何时发布的更多信息，请查看发布文档。

使用 Vite 的依赖

要替换依赖项传递使用的 Vite 版本，你应该使用 npm overrides 或 pnpm overrides。

社区

如果您有问题或需要帮助，请在 Discord 和 GitHub Discussions 上联系社区。

入门指南 ​

概述 ​

浏览器支持 ​

在线尝试 Vite ​

搭建你的第一个 Vite 项目 ​

社区模板 ​

手动安装 ​

index.html 和项目根目录 ​

指定替代根目录 ​

命令行界面 ​

使用未发布的提交 ​

社区 ​

入门指南

概述

浏览器支持

在线尝试 Vite

搭建你的第一个 Vite 项目

社区模板

手动安装

`index.html` 和项目根目录

指定替代根目录

命令行界面

使用未发布的提交

社区