Kurs Vue.js · Moduł 1: Vue i Vite

Vite - Silnik Napędowy Projektu

5 min czytania ·
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?

  1. 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_modules wstępnie paczkuje raz, przy pierwszym starcie
  2. Hot Module Replacement - po zapisaniu pliku podmienia tylko zmieniony moduł, bez przeładowania strony, niezależnie od rozmiaru projektu
  3. 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 --version

Dokumentacja 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@latest

Kreator 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?
│  No

JSX 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 TypeScript

Zwróć 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 deweloperskim

System 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. 1. Dlaczego Vite jest szybsze od tradycyjnych bundlerów?

  2. 2. Jaka komenda tworzy nowy projekt Vue z Vite?

  3. 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:

  1. PytanieSzybkość Vite
  2. PytanieTworzenie projektu Vue + Vite
  3. Zadanie z kodemPraktyka: Konfiguracja Vite
  4. Ułóż w kolejnościKroki tworzenia projektu Vue
  5. PytanieHot Module Replacement

Przydatne artykuły