Vite+快速上手:5分钟完成安装并跑通第一个项目(附完整命令清单)

原创2026-10-10 16:45:031,890 阅读
文章标签:开发工具构建工具CLI前端构建代码质量Lint测试Monorepo前端

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 —— 交互式创建新项目、应用或 Monorepo
  • vp 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 协议):

Vite+ 快速上手:连接 Vite、React、Svelte、Astro 等主流框架的统一工具链

一键安装 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>。

下一步学什么

搞定第一个项目后,这些官方文档值得深入:

Vite+ 统一 Web 开发工具链

现在打开终端,敲下 vp create,你的 Vite+ 之旅就开始了 🚀

登录后查看全文
vite-plus