Lar

Skill

Desenvolvimento Web

vite

antfu/skills

Configure a ferramenta de compilação Vite, utilize sua API de plug-ins, configure o SSR e migre para o Vite 8 com o Rolldown.

...Expandir tudo

Tempo atualizado 6 de Setembro de 2026

# typescript # vite # ssr # esm # build tool # oxc # plugin api # rolldown

Vite

Baseado no Vite 8 beta (com tecnologia Rolldown). O Vite 8 utiliza o empacotador Rolldown e o transformador Oxc.

Vite é uma ferramenta de compilação de front-end de última geração com servidor de desenvolvimento rápido (ESM nativo + HMR) e compilações de produção otimizadas.

Preferências

Usar TypeScript: preferir vite.config.ts
Sempre usar ESM, evitar CommonJS

Núcleo

Tópico	Descrição	Referência
Configuração	`vite.config.ts`, `defineConfig`, configurações condicionais, `loadEnv`	core-config
Recursos	`import.meta.glob`, consultas de ativos (`?raw`, `?url`), `import.meta.env`, API HMR	core-features
API de plug-ins	Viteganchos específicos, módulos virtuais, ordenação de plug-ins	API-de-plugins-do-núcleo

Compilação e SSR

Tópico	Descrição	Referência
Compilação e SSR	Modo de biblioteca, modo de middleware SSR, `ssrLoadModule`, API do JavaScript	build-and-ssr

Avançado

Tópico	Descrição	Referência
API de ambiente	Vite Suporte a múltiplos ambientes 6+, tempos de execução personalizados	environment-api
Migração por Rolldown	Vite 8 alterações: empacotador de rolldown, transformador Oxc, migração de configuração	rolldown-migration

Referência rápida

Comandos da CLI

vite              # Start dev server
vite build        # Production build
vite preview      # Preview production build
vite build --ssr  # SSR build

Configuração comum

import { defineConfig } from 'vite'

export default defineConfig({
  plugins: [],
  resolve: { alias: { '@': '/src' } },
  server: { port: 3000, proxy: { '/api': 'http://localhost:8080' } },
  build: { target: 'esnext', outDir: 'dist' },
})

Plug-ins oficiais

@vitejs/plugin-vue - Suporte a SFC do Vue 3
@vitejs/plugin-vue-jsx - Vue 3 JSX
@vitejs/plugin-react - React com Oxc/Babel
@vitejs/plugin-react-swc - React com SWC
@vitejs/plugin-legacy - Suporte a navegadores antigos

Ver no GitHub

---
name: vite
description: Configure Vite build tool, use its plugin API, set up SSR, and migrate to Vite 8 with Rolldown.
---

# Vite

> Based on Vite 8 beta (Rolldown-powered). Vite 8 uses Rolldown bundler and Oxc transformer.

Vite is a next-generation frontend build tool with fast dev server (native ESM + HMR) and optimized production builds.

## Preferences

- Use TypeScript: prefer `vite.config.ts`
- Always use ESM, avoid CommonJS

## Core

| Topic | Description | Reference |
|-------|-------------|-----------|
| Configuration | `vite.config.ts`, `defineConfig`, conditional configs, `loadEnv` | [core-config](references/core-config.md) |
| Features | `import.meta.glob`, asset queries (`?raw`, `?url`), `import.meta.env`, HMR API | [core-features](references/core-features.md) |
| Plugin API | Vite-specific hooks, virtual modules, plugin ordering | [core-plugin-api](references/core-plugin-api.md) |

## Build & SSR

| Topic | Description | Reference |
|-------|-------------|-----------|
| Build & SSR | Library mode, SSR middleware mode, `ssrLoadModule`, JavaScript API | [build-and-ssr](references/build-and-ssr.md) |

## Advanced

| Topic | Description | Reference |
|-------|-------------|-----------|
| Environment API | Vite 6+ multi-environment support, custom runtimes | [environment-api](references/environment-api.md) |
| Rolldown Migration | Vite 8 changes: Rolldown bundler, Oxc transformer, config migration | [rolldown-migration](references/rolldown-migration.md) |

## Quick Reference

### CLI Commands

```bash
vite              # Start dev server
vite build        # Production build
vite preview      # Preview production build
vite build --ssr  # SSR build
```

### Common Config

```ts
import { defineConfig } from 'vite'

export default defineConfig({
  plugins: [],
  resolve: { alias: { '@': '/src' } },
  server: { port: 3000, proxy: { '/api': 'http://localhost:8080' } },
  build: { target: 'esnext', outDir: 'dist' },
})
```

### Official Plugins

- `@vitejs/plugin-vue` - Vue 3 SFC support
- `@vitejs/plugin-vue-jsx` - Vue 3 JSX
- `@vitejs/plugin-react` - React with Oxc/Babel
- `@vitejs/plugin-react-swc` - React with SWC
- `@vitejs/plugin-legacy` - Legacy browser support