Vite+ v0.3.1 已发布！ • vp env 管理 Node.js 与包管理器版本 • 修复 TanStack Start 404 问题 • Windows shim 体积：214 → 14 KiB • 升级至 tsdown 0.23、oxlint 1.81、oxfmt 0.66 运行 vp upgrade，随后执行 vp migrate 以更新 pack 配置。 https://t.co/3BvEqrJl3O

voidzero-dev/vite-plus

源码仓库：https://github.com/voidzero-dev/vite-plus

统一的 Web 工具链 将运行时与包管理、项目创建、开发、检查、测试、构建、打包及 monorepo 任务缓存整合为单一依赖

Vite+ 是本地 Web 开发的统一入口。它将 Vite (https://vite.dev/)、Vitest (https://vitest.dev/)、Oxlint (https://oxc.rs/docs/guide/usage/linter.html)、Oxfmt (https://oxc.rs/docs/guide/usage/formatter.html)、Rolldown (https://rolldown.rs/)、tsdown (https://tsdown.dev/) 和 Vite Task (https://github.com/voidzero-dev/vite-task) 整合为一个零配置工具链，同时管理运行时与包管理工作流：

• vp env：全局或按项目管理 Node.js 和包管理器
• vp install：自动检测包管理器并安装依赖
• vp dev：运行 Vite 的高性能原生 ESM 开发服务器，支持即时热更新
• vp check：一键执行格式化、代码检查与类型检查
• vp test：通过内置 Vitest 运行测试
• vp build：使用 Vite + Rolldown 构建生产环境应用
• vp run：执行 package.json 脚本和 monorepo 任务，支持缓存与依赖感知调度
• vp pack：构建用于 npm 发布的库或独立应用二进制文件
• vp toolchain：显示 Vite+、Vite、Rolldown、Oxc 及其他工具的版本
• 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.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 - 配置钩子与代理集成
• hooks - 管理 Git 钩子分发器
• staged - 对暂存文件运行代码检查

开发

• install（i）- 安装依赖
• env - 管理 Node.js 和包管理器
• dev - 启动开发服务器
• check - 执行格式化、代码检查和类型检查
• lint - 代码检查
• fmt - 代码格式化
• test - 运行测试

执行

• run - 运行 monorepo 任务
• exec - 从本地 node_modules/.bin 执行命令
• node - 使用解析后的 Vite+ 环境运行 Node.js 脚本
• dlx - 执行包二进制文件（无需安装为依赖）
• cache - 管理任务缓存

构建

• build - 生产环境构建
• pack - 构建库
• preview - 预览生产构建

依赖管理

Vite+ 基于 packageManager 和锁文件自动封装包管理器（pnpm、npm、Yarn 或 Bun）：

• add - 添加依赖
• remove（rm、un、uninstall）- 移除依赖
• update（up）- 更新依赖至最新版本
• dedupe - 依赖去重
• outdated - 检查过期依赖
• list（ls）- 列出已安装依赖
• why（explain）- 显示依赖安装原因
• info（view、show）- 查看注册表中的包信息
• link（ln）/ unlink - 管理本地包链接
• rebuild - 重新构建原生模块
• pm - 向包管理器传递命令

维护

• toolchain - 显示 Vite+ 工具版本及其关系
• upgrade - 更新 vp 自身至最新版本
• implode - 移除 vp 及所有相关数据

搭建首个 Vite+ 项目

使用 vp create 创建新项目：

vp create

可在项目内运行 vp create 为现有项目添加新应用或库。组织可通过在 npm 范围内发布 @org/create 并在其 package.json 中包含 createConfig.templates 清单，来提供一组精选模板。发布后，vp create @org 会打开这些模板的交互式选择器，在 vite.config.ts 中设置 create: { defaultTemplate: '@org' } 可将其设为裸 vp create 的默认模板。

详情参阅组织模板指南（https://viteplus.dev/guide/create#organization-templates）及 create.defaultTemplate 配置说明（https://viteplus.dev/config/create）。

迁移现有项目

可通过以下命令迁移现有项目：

vp migrate

GitHub Actions

使用官方 setup-vp（https://github.com/voidzero-dev/setup-vp）Action 在 GitHub Actions 中安装 Vite+：

- uses: voidzero-dev/setup-vp@<version>
  with:
    node-version: '22'
    cache: true

将 <version> 设为 setup-vp 发布页面（https://github.com/voidzero-dev/setup-vp/releases）上的确切版本号，也可使用提交 SHA。请勿使用 v1 标签（该标签已停止更新）。请参阅自动版本更新指南（https://viteplus.dev/guide/ci#automatic-version-updates）配置 Dependabot 或 Renovate。

手动安装与迁移

手动迁移项目至 Vite+ 时，请先安装以下开发依赖：

vp install -D vite-plus

添加包管理器覆盖配置，使其他包使用 Vite+ 版本。将 vite 别名设为 @voidzero-dev/vite-plus-core，并将 vitest 固定为 vp toolchain vitest 显示的版本，确保项目与 vp test 使用相同的 Vitest 副本。若不固定版本，依赖或工作区包可能安装不同版本的 Vitest，导致模拟（mock）、expect 函数和测试运行器状态不一致：

"overrides": {
  "vite": "npm:@voidzero-dev/vite-plus-core@latest",
  "vitest": "4.1.11"
}

若使用 pnpm，请在 pnpm-workspace.yaml 中添加：

overrides:
  vite: npm:@voidzero-dev/vite-plus-core@latest
  vitest: 4.1.11

若使用 Yarn：

"resolutions": {
  "vite": "npm:@voidzero-dev/vite-plus-core@latest",
  "vitest": "4.1.11"
}

赞助商

感谢 namespace.so（https://namespace.so）提供快速、免费的 macOS、Linux 和 Windows 运行环境，支持我们的 CI/CD 流水线。