Vite+快速上手:5分钟完成安装并跑通第一个项目(附完整命令清单)
Vite+快速上手:5分钟完成安装并跑通第一个项目(附完整命令清单)
Vite+(包名 vite-plus)是 Web 开发的统一工具链与统一入口:它把 Vite、Vitest、Oxlint、Oxfmt、Rolldown 等多个常用工具整合进一个依赖,用一个 vp 命令就能完成从安装依赖、启动开发服务器、跑测试到生产构建的完整流程。这篇 Vite+ 快速上手教程带你 5 分钟装好 vp 并跑通第一个项目,文末附完整命令清单,方便随时查阅。
Vite+ 是什么?为什么值得试试
传统前端项目里,开发服务器用 Vite、测试用 Vitest、检查用 ESLint + Prettier、构建再配一堆……而 Vite+ 的理念是:一个 CLI,覆盖开发生命周期。你只需要记住一个命令 vp:
vp create—— 交互式创建新项目、应用或 Monorepovp dev—— 启动 Vite 原生 ESM 开发服务器,毫秒级热更新vp check—— 一条命令跑完格式化 + Lint + 类型检查vp test—— 通过内置 Vitest 运行测试vp build—— Vite + Rolldown 生产构建vp env—— 管理 Node.js 运行时和包管理器(npm / pnpm / Yarn / Bun)
Vite+ 兼容整个 Vite 框架生态(React、Vue、Svelte、Astro、Qwik、Solid 等),并且完全开源(MIT 协议):
一键安装 vp CLI:最快 3 分钟完成
安装只需一条命令,全局可用,跨项目生效。
macOS / Linux
curl -fsSL https://vite.plus | bash
Windows(PowerShell)
irm https://viteplus.dev/install.ps1 | iex
验证安装是否成功
安装完成后打开一个新的终端,运行:
vp help
如果能看到完整的命令列表,说明 Vite+ 已装好 ✅
💡 Vite+ 会顺带管理你机器上的 Node.js 运行时和包管理器。如果你想保持自己现有的环境,可以运行
vp env off关闭这一行为。
快速开始:5 条命令跑通第一个项目
安装完成后,在你想放项目的目录下依次执行:
vp create # 1️⃣ 创建新项目(交互式选择模板)
vp install # 2️⃣ 安装依赖(自动识别 npm/pnpm/Yarn/Bun)
vp dev # 3️⃣ 启动开发服务器,修改代码即时刷新
vp check # 4️⃣ 一次性完成格式化 + Lint + 类型检查
vp build # 5️⃣ 构建生产版本
逐步来看:
第 1 步:vp create —— 交互式脚手架。可以创建独立应用(vite:application)、库(vite:library)或 Monorepo(vite:monorepo),也支持社区模板(如 vp create vite、vp create svelte),详见 docs/guide/create.md。
第 2 步:vp install —— 根据 package.json 中的 packageManager 字段和锁文件自动选择正确的包管理器安装依赖,省去手动判断。
第 3 步:vp dev —— 启动标准 Vite 开发服务器,保留完整的 Vite 开发体验(插件、别名、环境变量、端口配置等),详见 docs/guide/dev.md。
第 4 步:vp check —— Vite+ 的"质检"命令:把 Oxfmt 格式化、Oxlint 检查、TypeScript 类型检查合并为一条命令,比分开跑三个工具更快。开发中推荐配合 vp check --fix 自动修复。
第 5 步:vp build —— 生产构建,构建完可以用 vp preview 本地预览产物,详见 docs/guide/build.md。
跑起来之后,整个开发循环就是:vp dev 写代码 → vp check 保质量 → vp test 跑测试 → vp build 出产物。
一处配置管全部:vite.config.ts
Vite+ 的另一个亮点是零散配置文件的终结。开发服务器、测试、Lint、格式化、任务脚本、提交前检查……全部收敛到根目录的一个 vite.config.ts 中,且类型安全:
import { defineConfig } from 'vite-plus';
export default defineConfig({
plugins: [], // 标准 Vite 配置
test: { include: ['src/**/*.test.ts'] }, // Vitest 配置
lint: { ignorePatterns: ['dist/**'] }, // Oxlint 配置
fmt: { singleQuote: true }, // Oxfmt 配置
run: { tasks: { /* Monorepo 任务 */ } }, // 任务脚本
staged: { '*': 'vp check --fix' }, // 提交前检查
});
已有项目想用 Vite+?一条命令迁移:
vp migrate
它会自动把 .oxlintrc*、.oxfmtrc*、lint-staged 等工具专属配置文件合并进 vite.config.ts。
完整 vp 命令清单(建议收藏)
下表按使用场景整理了 vp 的常用命令,建议收藏备用:
🚀 启动项目
| 命令 | 作用 |
|---|---|
vp create |
从模板创建新项目(应用 / 库 / Monorepo) |
vp migrate |
把现有项目迁移到 Vite+ |
vp install(vp i) |
安装依赖,自动识别包管理器 |
vp env |
管理 Node.js 与包管理器环境 |
🛠️ 日常开发
| 命令 | 作用 |
|---|---|
vp dev |
启动 Vite 开发服务器(即时 HMR) |
vp check |
格式化 + Lint + 类型检查一把梭 |
vp lint / vp fmt |
单独执行检查 / 格式化 |
vp test |
通过内置 Vitest 运行测试 |
vp staged |
对 Git 暂存文件运行检查 |
▶️ 执行任务
| 命令 | 作用 |
|---|---|
vp run |
运行 Monorepo 任务,支持缓存与依赖感知调度 |
vp exec |
执行 node_modules/.bin 中的本地命令 |
vp node |
用 Vite+ 解析的环境运行 Node 脚本 |
vp dlx |
不安装依赖直接运行某个包的二进制 |
vp cache clean |
清理任务缓存 |
📦 构建发布
| 命令 | 作用 |
|---|---|
vp build |
生产构建(Vite + Rolldown) |
vp preview |
本地预览生产构建 |
vp pack |
构建库(npm 发布)或独立应用产物 |
🧩 依赖管理(自动适配 npm / pnpm / Yarn / Bun)
| 命令 | 作用 |
|---|---|
vp add / vp remove / vp update |
添加 / 移除 / 更新依赖 |
vp outdated / vp dedupe |
查看过期依赖 / 去重 |
vp list / vp why / vp info |
列出依赖 / 追溯来源 / 查看元数据 |
vp link / vp unlink |
本地包链接管理 |
vp pm <command> |
透传命令给底层包管理器 |
🔧 工具维护
| 命令 | 作用 |
|---|---|
vp toolchain |
查看 Vite+、Vite、Rolldown 等工具版本 |
vp upgrade |
升级 vp 本身到最新版 |
vp implode |
彻底卸载 vp 及相关数据 |
⚠️ 小提示:
vp dev、vp build等是 Vite+ 内置命令,不可覆盖。如果你想运行package.json里自己写的脚本,请使用vp run <script>。
下一步学什么
搞定第一个项目后,这些官方文档值得深入:
- 快速开始总览:docs/guide/index.md
- 项目创建与模板:docs/guide/create.md
- 项目迁移:docs/guide/migrate.md
- 开发服务器配置:docs/guide/dev.md
- 测试指南:docs/guide/test.md
- 命令参考:README.md
现在打开终端,敲下 vp create,你的 Vite+ 之旅就开始了 🚀

