Bien démarrer

Ajoutez Vize à votre application Vue 3 avec Vite+. Gardez les réglages des outils dans vite.config.ts et le projet TypeScript dans tsconfig.json. Vize est en développement ; vérifiez son niveau de support avant de l'adopter.

1. Installer l'intégration

Dans un projet Vue existant équipé de Vite+ :

vp install -D @vizejs/vite-plugin

L'intégration utilise la version Vite+ du projet (0.2.3 ou ultérieure). Pour Vite classique, consultez la migration du plugin ; pour Nuxt, consultez l'intégration Nuxt.

2. Modifier vite.config.ts

La fonction ajoute le compilateur Vize et les tâches natives de vérification. Retirez l'import de l'ancien plugin Vue et vue() de plugins, puis conservez les alias, le serveur, les tests et les autres plugins. Le guide de migration montre les exemples avant et après.

import { defineConfig } from "@vizejs/vite-plugin/vite-plus";

export default defineConfig({});

3. Construire et vérifier l'application

vp dev
vp build
vp run check

vp run check combine la vérification des types Vue, le lint et le formatage avec Oxlint et Oxfmt. Utilisez les tâches ciblées pendant le développement :

vp run typecheck
vp run lint
vp run fmt:check

Appliquez les corrections avec vp run check -- --fix. Utilisez vp run pour les tâches Vize générées : vp check, vp lint et vp fmt exécutent les outils propres à Vite+. Vize conserve les scripts existants et génère vize:<nom> en cas de conflit ; consultez les noms et remplacements.

Choisir la suite

• Configurer une règle ou une option du compilateur.
• Migrer les outils existants avec des exemples avant/après complets.
• Comprendre un diagnostic lint avec des exemples Vue incorrects et corrigés.
• Explorer les composants, leurs recettes et leur API.
• Prévisualiser les composants avec Musea.
• Configurer l'éditeur avec les réglages natifs partagés.

Les guides qui ne sont pas encore traduits s'ouvrent en anglais.

Note

La CLI, l’intégration Vite et l’éditeur partagent les réglages vue: dans vite.config.* et utilisent le projet TypeScript et les vueCompilerOptions de tsconfig.json. Les fichiers dédiés vize.config.* et les réglages vize: à la racine ne sont plus pris en charge ; consultez le guide de configuration pour migrer.

Utiliser Vize sans Vite+

Essayez la CLI sans rien installer :

vpx vize lint src
vpx vize check
vpx vize fmt --check src

La CLI autonome fournit vize lint, vize fmt et vize check. Lancez-les depuis la racine du paquet ciblé et gardez le projet TypeScript dans tsconfig.json. Les commandes natives peuvent partager l'objet vue à la racine de vite.config.* ; consultez la configuration CLI pour la recherche et ses limites actuelles.

Prévisualisez l'installation interactive avec vpx vize init --dry-run, puis lancez vpx vize init pour choisir les fonctions. Le guide d'installation décrit la détection et les limites d'édition. Init utilise les réglages du projet et les valeurs par défaut, sans créer de configuration Vize dédiée.