Web 统一工具链 运行时和包管理、创建、开发、检查、测试、构建、打包以及单仓库任务缓存,全部集成在一个依赖中
Vite+ 是本地 Web 开发的统一入口。它将 Vite、Vitest、Oxlint、Oxfmt、Rolldown、tsdown 和 Vite Task 整合到一个零配置工具链中,同时还管理运行时和包管理器工作流:
vp env: 全局和按项目方式管理 Node.jsvp install: 自动检测包管理器并安装依赖vp dev: 运行 Vite 的快速原生 ESM 开发服务器,支持即时热更新vp check: 一键运行格式化、代码检查和类型检查vp test: 通过内置的 Vitest 运行测试vp build: 使用 Vite + Rolldown 构建生产环境应用vp run: 执行单仓库任务,支持缓存和依赖感知调度vp pack: 构建用于 npm 发布的库或独立应用二进制文件vp create/vp migrate: 搭建新项目并迁移现有项目
所有这些都可以从项目根目录进行配置,并且可以在 Vite 的框架生态系统中工作。 Vite+ 在 MIT 许可证下完全开源。
开始使用
全局安装 Vite+ 为 vp:
Linux 或 macOS:
curl -fsSL https://vite.plus | bash
Windows:
irm https://viteplus.dev/install.ps1 | iex
vp 处理完整的开发生命周期,包括包管理、开发服务器、代码检查、格式化、测试和生产构建。
配置 Vite+
Vite+ 可以使用项目根目录下的单个 vite.config.ts 进行配置:
import { defineConfig } from 'vite-plus';
export default defineConfig({
// 用于开发/构建/预览的标准 Vite 配置。
plugins: [],
// Vitest 配置。
test: {
include: ['src/**/*.test.ts'],
},
// Oxlint 配置。
lint: {
ignorePatterns: ['dist/**'],
},
// Oxfmt 配置。
fmt: {
semi: true,
singleQuote: true,
},
// Vite Task 配置。
run: {
tasks: {
'generate:icons': {
command: 'node scripts/generate-icons.js',
envs: ['ICON_THEME'],
},
},
},
// `vp staged` 配置。
staged: {
'*': 'vp check --fix',
},
});
这样,您可以将开发服务器、构建、测试、代码检查、格式化、任务运行器和暂存文件工作流的配置集中在一个地方,具有类型安全的配置和共享的默认设置。
使用 vp migrate 迁移到 Vite+。它会将特定于工具的配置文件(如 .oxlintrc*、.oxfmtrc* 和 lint-staged 配置)合并到 vite.config.ts 中。
CLI 工作流(vp help)
启动
- create - 从模板创建新项目
- migrate - 将现有项目迁移到 Vite+
- config - 配置钩子和代理集成
- staged - 对暂存文件运行代码检查器
- install (
i) - 安装依赖 - env - 管理 Node.js 版本
开发
- dev - 运行开发服务器
- check - 运行格式化、代码检查和类型检查
- lint - 代码检查
- fmt - 格式化代码
- test - 运行测试
执行
- run - 运行单仓库任务
- exec - 从本地
node_modules/.bin执行命令 - dlx - 执行包二进制文件,无需将其安装为依赖项
- cache - 管理任务缓存
构建
- build - 生产环境构建
- pack - 构建库
- preview - 预览生产构建
管理依赖
Vite+ 根据 packageManager 和锁定文件自动包装您的包管理器(pnpm、npm 或 Yarn):
- add - 添加包到依赖项
- remove (
rm,un,uninstall) - 从依赖项中移除包 - update (
up) - 将包更新到最新版本 - dedupe - 去重依赖项
- outdated - 检查过时的包
- list (
ls) - 列出已安装的包 - why (
explain) - 显示为什么安装了某个包 - info (
view,show) - 从注册表查看包元数据 - link (
ln) / unlink - 管理本地包链接 - pm - 将命令转发给包管理器
维护
- upgrade - 将
vp本身更新到最新版本 - implode - 移除
vp和所有相关数据
搭建您的第一个 Vite+ 项目
使用 vp create 创建新项目:
vp create
您可以在项目内部运行 vp create 以向项目添加新的应用或库。
迁移现有项目
您可以将现有项目迁移到 Vite+:
vp migrate
GitHub Actions
使用官方的 setup-vp action 在 GitHub Actions 中安装 Vite+:
- uses: voidzero-dev/setup-vp@v1
with:
node-version: '22'
cache: true
手动安装和迁移
如果您正在手动将项目迁移到 Vite+,请首先安装这些开发依赖:
npm install -D vite-plus @voidzero-dev/vite-plus-core@latest
您需要为 vite 和 vitest 向您的包管理器添加覆盖,以便其他依赖 Vite 和 Vitest 的包使用 Vite+ 版本:
"overrides": {
"vite": "npm:@voidzero-dev/vite-plus-core@latest",
"vitest": "npm:@voidzero-dev/vite-plus-test@latest"
}
如果您使用 pnpm,请在 pnpm-workspace.yaml 中添加:
overrides:
vite: npm:@voidzero-dev/vite-plus-core@latest
vitest: npm:@voidzero-dev/vite-plus-test@latest
或者,如果您使用 Yarn:
"resolutions": {
"vite": "npm:@voidzero-dev/vite-plus-core@latest",
"vitest": "npm:@voidzero-dev/vite-plus-test@latest"
}