Kurs Vue.js · Moduł 1: Vue i Vite
Vite - Silnik Napędowy Projektu
W tej lekcji6
W NOVA LAB używamy najnowocześniejszych narzędzi. Vite to nasz "silnik napędowy" - kompiluje kod szybciej niż rakieta osiąga pierwszą prędkość kosmiczną!
Po co w ogóle silnik? Przeglądarka nie rozumie plików .vue ani TypeScriptu, a aplikacja misji to setki modułów, które importują się nawzajem. Starsze narzędzia, tak zwane bundlery, przed pokazaniem czegokolwiek sklejały całą aplikację w jedną paczkę, więc im większy projekt, tym dłużej czekałeś na start serwera i na każdą poprawkę.
Czym jest Vite?
Vite (francuskie słowo oznaczające "szybki", wymawiane "wit") to narzędzie budujące nowej generacji. Stworzył go Evan You - ten sam twórca co Vue.js. Vite łączy dwie role: serwer deweloperski, na którym testujesz aplikację, oraz budowanie wersji produkcyjnej.
Dlaczego Vite jest tak szybki?
- Native ES Modules - w trybie deweloperskim serwuje Twój kod przeglądarce jako moduły ES, na żądanie, bez bundlowania całej aplikacji; zależności z
node_moduleswstępnie paczkuje raz, przy pierwszym starcie - Hot Module Replacement - po zapisaniu pliku podmienia tylko zmieniony moduł, bez przeładowania strony, niezależnie od rozmiaru projektu
- Natywne narzędzia - do wersji 7 Vite korzystał z esbuild (według ówczesnej dokumentacji wstępnie paczkował zależności 10-100 razy szybciej niż bundlery pisane w JavaScripcie) oraz z Rollupa przy buildzie produkcyjnym; od Vite 8 obie role przejął Rolldown, bundler napisany w Rust, a kod przetwarza Oxc
Paliwo: Node.js
Silnik potrzebuje paliwa, a jest nim Node.js. Zanim uruchomisz kreator projektu, sprawdź w terminalu, jaką wersję masz zainstalowaną:
node --versionDokumentacja Vue wymaga obecnie Node.js w wersji 22.18 lub nowszej z linii 22 albo 24.12 lub nowszej. Na starszej wersji narzędzia mogą zgłaszać ostrzeżenia albo w ogóle się nie uruchomić, więc ten krok wykonuj zawsze jako pierwszy.
Inicjalizacja Projektu Misji
Aby uruchomić nowy projekt systemu, użyj protokołu startowego. To polecenie pobiera i uruchamia create-vue, oficjalny kreator projektów Vue, a dopisek @latest gwarantuje jego najnowszą wersję:
npm create vue@latestKreator zada pytania o konfigurację misji. Funkcje zaznaczasz na liście spacją i zatwierdzasz Enterem:
◇ Project name (target directory):
│ mars-control-system
│
◇ Use TypeScript?
│ Yes
│
◇ Select features to include in your project:
│ Router (SPA development), Pinia (state management), Vitest (unit testing), Linter (error prevention), Prettier (code formatting)
│
◇ Select experimental features to include in your project:
│ none
│
◇ Skip all example code and start with a blank Vue project?
│ NoJSX pomijamy, bo w Vue piszemy szablony, a funkcji eksperymentalnych nie włączamy na produkcyjnej misji. Starsze wersje kreatora zadawały te same pytania pojedynczo, na przykład "Add TypeScript? … Yes" albo "Add Pinia? … Yes" - zmieniła się forma, wybory zostały te same.
Struktura Systemu Misji
Po zakończeniu pracy kreator zostawia katalog o takiej strukturze:
mars-control-system/
├── public/ # Zasoby statyczne (ikony, manifesty)
├── src/
│ ├── assets/ # Grafiki, style CSS
│ ├── components/ # Moduły interfejsu
│ ├── views/ # Ekrany główne
│ ├── router/ # Konfiguracja nawigacji
│ ├── stores/ # Bazy danych Pinia
│ ├── App.vue # Główny komponent
│ └── main.ts # Punkt startowy systemu
├── index.html # Szablon HTML
├── package.json # Manifest zależności
├── vite.config.ts # Konfiguracja silnika Vite
└── tsconfig.json # Konfiguracja TypeScriptZwróć uwagę, że index.html leży w katalogu głównym, a nie w public/ - dla Vite to punkt wejścia aplikacji. Katalogi router/ i stores/ pojawiają się tylko wtedy, gdy wybierzesz Router i Pinię. Hierarchia komponentów zaczyna się od App.vue: niżej stoją komponenty układu, na przykład nagłówek i pasek boczny, które otaczają widoki z views/, a widoki składają się z najmniejszych modułów z components/, takich jak przyciski i karty.
Konfiguracja Silnika
Plik vite.config.ts (albo vite.config.js bez TypeScriptu) mówi Vite, jak ma pracować. Funkcja defineConfig daje edytorowi podpowiedzi, plugin vue() z pakietu @vitejs/plugin-vue uczy Vite rozumieć pliki .vue, a alias @ jest skrótem do katalogu src:
import { fileURLToPath, URL } from 'node:url'
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
export default defineConfig({
plugins: [vue()],
resolve: {
alias: {
'@': fileURLToPath(new URL('./src', import.meta.url))
}
}
})Funkcje fileURLToPath i URL z wbudowanego modułu node:url zamieniają zapis ./src na pełną ścieżkę na dysku. Kreator dopisuje tu jeszcze plugin vueDevTools(), do którego wrócimy przy narzędziach diagnostycznych. Kod komponentów się nie zmienia - konfiguracja dotyczy wyłącznie narzędzia - ale import z głęboko położonego pliku robi się krótki:
// zamiast '../../components/ModuleCard.vue'
import ModuleCard from '@/components/ModuleCard.vue'Alias działa tak samo z każdego miejsca projektu, więc po przeniesieniu pliku do innego katalogu nie poprawiasz w nim ścieżek.
Uruchomienie Systemu
Zostały trzy komendy: wejście do katalogu projektu, instalacja zależności i start serwera deweloperskiego:
cd mars-control-system
npm install # Załaduj moduły
npm run dev # Uruchom w trybie deweloperskimSystem uruchomi się na http://localhost:5173 - nasz lokalny symulator. Zmień napis w dowolnym komponencie i zapisz plik, a HMR podmieni moduł bez przeładowania strony. Polecam Ci trzymać serwer włączony w osobnym oknie terminala przez całą sesję pracy. W następnej lekcji zajrzymy do środka plików .vue, które plugin Vue kompiluje dla przeglądarki.
W edytorze poniżej wpisz komunikat w polu tekstowym albo zmień dowolny napis w kodzie i obserwuj, jak podgląd odświeża się bez przeładowania.
Zapamiętaj: npm create vue@latest buduje rakietę, npm install tankuje moduły, a npm run dev odpala silnik Vite na porcie 5173.
Kod do tej lekcji: src/App.vue
<template>
<div class="nova-lab">
<h1>Vite + Vue.js - Błyskawiczna Konfiguracja</h1>
<section class="info-panel">
<h2>Dlaczego Vite?</h2>
<div class="feature-grid">
<div class="feature" v-for="feature in viteFeatures" :key="feature.title">
<span class="icon">{{ feature.icon }}</span>
<h3>{{ feature.title }}</h3>
<p>{{ feature.description }}</p>
</div>
</div>
</section>
<section class="demo-panel">
<h2>Hot Module Replacement w akcji</h2>
<p>Edytuj kod i zobacz zmiany natychmiast!</p>
<div class="hmr-demo">
<input v-model="message" placeholder="Wpisz wiadomość..." />
<p class="preview">{{ message || 'Twoja wiadomość pojawi się tutaj...' }}</p>
</div>
</section>
</div>
</template>
<script setup>
import { ref } from 'vue'
const message = ref('')
const viteFeatures = [
{
icon: '',
title: 'Błyskawiczny start',
description: 'Serwer startuje w milisekundach dzięki natywnym ES modules'
},
{
icon: '',
title: 'Hot Module Replacement',
description: 'Zmiany widoczne natychmiast bez przeładowania strony'
},
{
icon: '',
title: 'Optymalizowany build',
description: 'Rolldown pod spodem (od Vite 8) dla produkcyjnych bundli'
},
{
icon: '',
title: 'TypeScript',
description: 'Wsparcie TypeScript out-of-the-box'
}
]
</script>
<style>
.nova-lab {
min-height: 100vh;
background: #0a0e27;
color: #e0e0e0;
padding: 2rem;
font-family: system-ui, sans-serif;
}
h1 {
color: #00ff88;
text-align: center;
margin-bottom: 2rem;
}
section {
background: rgba(26, 30, 55, 0.8);
border: 1px solid #00b4d8;
border-radius: 12px;
padding: 1.5rem;
margin-bottom: 1.5rem;
max-width: 900px;
margin-left: auto;
margin-right: auto;
}
h2 {
color: #00b4d8;
margin-top: 0;
}
.feature-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
gap: 1rem;
}
.feature {
background: rgba(0, 180, 216, 0.1);
padding: 1rem;
border-radius: 8px;
text-align: center;
}
.feature .icon {
font-size: 2rem;
}
.feature h3 {
color: #00ff88;
margin: 0.5rem 0;
}
.feature p {
font-size: 0.9rem;
color: #aaa;
margin: 0;
}
.hmr-demo {
margin-top: 1rem;
}
.hmr-demo input {
width: 100%;
padding: 1rem;
background: #1a1e37;
border: 2px solid #00b4d8;
border-radius: 8px;
color: #fff;
font-size: 1rem;
}
.hmr-demo input:focus {
outline: none;
border-color: #00ff88;
}
.preview {
margin-top: 1rem;
padding: 1rem;
background: rgba(0, 255, 136, 0.1);
border-radius: 8px;
color: #00ff88;
font-style: italic;
}
</style>Hasła z dokumentacji w tej lekcji
Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Dlaczego Vite jest szybsze od tradycyjnych bundlerów?
2. Jaka komenda tworzy nowy projekt Vue z Vite?
3. Co to jest HMR (Hot Module Replacement) w Vite?
Zadania praktyczne w grze
- Edytor kodu
Uzupełnij plik vite.config.js dodając plugin Vue i alias '@' wskazujący na src/.
- Układanie w pionie
Ułóż kroki tworzenia nowego projektu Vue + Vite w odpowiedniej kolejności: