Accueil › Vue.js › Créer un projet avec Vite
Créer un projet avec Vite
Démarrer avec Vuedebutant
L'outillage officiel s'obtient par une seule commande.
npm create vue@latest
L'outil pose des questions — nom du projet, TypeScript, routeur, magasin d'état, tests, analyse statique — puis écrit un projet Vite complet. On répond ensuite :
cd mon-projet
npm install
npm run dev
Le serveur démarre en quelques centaines de millisecondes et affiche une adresse locale. Toute modification d'un fichier apparaît dans la page sans rechargement, et sans perdre l'état courant du formulaire ouvert.
Le projet obtenu a toujours la même ossature :
index.html le point d'entrée HTML, avec <div id="app">
vite.config.ts les plugins, dont @vitejs/plugin-vue
package.json les scripts dev / build / preview
src/main.ts createApp(App).mount('#app')
src/App.vue le composant racine
src/components/ les autres composants
index.html est à la racine, pas dans src/ : pour Vite, c'est un fichier
source, le point de départ du graphe de modules.
// src/main.ts
import { createApp } from 'vue'
import App from './App.vue'
import './style.css'
createApp(App).mount('#app')
Trois scripts suffisent au quotidien : npm run dev pour développer,
npm run build pour produire le dossier dist/, npm run preview pour
servir ce dist/ et vérifier le résultat réel avant livraison.
Les termes à connaître
- Vite
L'outil de développement et de construction recommandé pour Vue. En développement il sert les modules ES natifs du navigateur ; pour la production il produit un paquet optimisé.
- create-vue
L'outil d'échafaudage officiel, lancé par
npm create vue@latest. Il pose un projet Vite déjà configuré et pose des questions sur l'outillage souhaité.- Serveur de développement
Le processus lancé par
npm run dev. Il compile à la demande et pousse les modifications dans la page ouverte sans recharger.- HMR
« Hot Module Replacement » : le remplacement d'un module modifié dans la page en cours, sans rechargement, donc sans perte de l'état courant.
- Point de montage
L'élément du DOM remplacé par l'application, désigné par
.mount('#app'). Tout ce qui s'y trouvait est écrasé au montage.- vite.config
Le fichier de configuration de Vite. C'est là qu'on déclare les plugins — dont
@vitejs/plugin-vue, sans lequel aucun fichier.vuene compile — et les alias de chemins.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.