Kurs Next.js · Moduł 1: Konfiguracja Next.js
Instalacja i konfiguracja środowiska programistycznego
W tej lekcji15
W Metropolii Quantum, zanim inżynier może rozpocząć pracę nad systemami miasta, musi przygotować swoje biometryczne stanowisko kwantowe. Podobnie, jako programista Next.js, musisz najpierw skonfigurować swoje środowisko deweloperskie. W tym module nauczysz się, jak zainstalować i skonfigurować wszystkie niezbędne narzędzia do tworzenia aplikacji w Next.js 16.
Wymagania systemowe
Zanim rozpoczniemy instalację, upewnij się, że Twój komputer spełnia minimalne wymagania. Podobnie jak kwantowe terminale w Metropolii Quantum wymagają określonych specyfikacji energetycznych, tak środowisko Next.js potrzebuje odpowiednich wersji oprogramowania:
- Node.js - wersja 20.9 lub nowsza (Next.js 16 nie obsługuje już Node.js 18; najlepiej wybierz aktualną wersję LTS)
- TypeScript (opcjonalnie) - wersja 5.1 lub nowsza
- macOS, Windows (w tym WSL) lub Linux
- Minimum 1GB RAM (zalecane 4GB lub więcej dla większych projektów)
- Edytor kodu - zalecane Visual Studio Code z rozszerzeniami dla React/Next.js
Instalacja Node.js i npm
Node.js to jak generator energii kwantowej dla Twojego środowiska deweloperskiego - zasila wszystkie procesy i narzędzia.
Windows i macOS
- Odwiedź oficjalną stronę Node.js
- Pobierz i zainstaluj najnowszą wersję LTS (Long Term Support)
- Sprawdź instalację, otwierając terminal i wpisując:
node -v
npm -vPowinieneś zobaczyć numery wersji Node.js i npm (Node Package Manager).
Linux (Ubuntu/Debian)
# Repozytoria Ubuntu 22.04/24.04 i Debiana 12 mają za stary Node.js (12 lub 18),
# a Next.js 16 wymaga wersji 20.9 lub nowszej. Zainstaluj aktualne LTS z NodeSource:
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install nodejsZarządzanie wersjami Node.js
Dla bardziej zaawansowanych użytkowników, podobnie jak inżynierowie Metropolii Quantum używają systemów wirtualizacji do testowania różnych konfiguracji energetycznych, możesz użyć narzędzi do zarządzania wersjami Node.js:
- nvm (Node Version Manager) dla macOS/Linux
- nvm-windows dla Windows
# Instalacja nvm (macOS/Linux)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
# Instalacja określonej wersji Node.js
nvm install 24
nvm use 24Instalacja edytora kodu
W Metropolii Quantum holograficzne edytory kodu są zintegrowane z neuronowymi implantami inżynierów. Na szczęście w naszym świecie wystarczy zainstalować dobry edytor kodu na komputerze. Visual Studio Code to obecnie jeden z najpopularniejszych edytorów dla programistów Next.js.
- Pobierz i zainstaluj Visual Studio Code
- Zainstaluj przydatne rozszerzenia:
- ES7+ React/Redux/React-Native snippets - szablony kodu
- ESLint - analiza statyczna kodu
- Prettier - formatowanie kodu
- Tailwind CSS IntelliSense (jeśli planujesz używać Tailwind CSS)
- GitHub Copilot (opcjonalnie) - asystent AI dla programistów
Tworzenie nowego projektu Next.js
Teraz, gdy masz już zainstalowane niezbędne narzędzia, możesz stworzyć swój pierwszy projekt Next.js 16. Vercel udostępnia wygodne narzędzie create-next-app, które automatycznie konfiguruje projekt z najlepszymi praktykami.
npx create-next-app@latest my-quantum-appPodczas instalacji zostaniesz poproszony o odpowiedź na kilka pytań konfiguracyjnych:
Would you like to use the recommended Next.js defaults? No, customize settings
Would you like to use TypeScript? Yes
Which linter would you like to use? ESLint
Would you like to use React Compiler? No
Would you like to use Tailwind CSS? Yes
Would you like your code inside a `src/` directory? Yes
Would you like to use App Router? (recommended) Yes
Would you like to customize the import alias (`@/*` by default)? No
Would you like to include AGENTS.md to guide coding agents to write up-to-date Next.js code? YesW Next.js 16 kreator zaczyna od pytania o zalecane ustawienia domyślne: odpowiedź "Yes, use recommended defaults" od razu wybiera TypeScript, ESLint, Tailwind CSS, App Router i plik AGENTS.md. Wybieramy "No, customize settings", bo chcemy dodatkowo umieścić kod w katalogu src/. React Compiler, który automatycznie memoizuje komponenty, na razie zostawiamy wyłączony, a AGENTS.md to plik z instrukcjami dla asystentów AI, wskazujący im dokumentację zgodną z zainstalowaną wersją Next.js.
Zalecamy odpowiedź "Yes" na większość pytań, zwłaszcza dotyczących TypeScript i App Router, które są kluczowe dla nowoczesnych aplikacji Next.js 16.
Po zakończeniu instalacji przejdź do katalogu projektu i uruchom serwer deweloperski:
cd my-quantum-app
npm run devTwoja aplikacja powinna być teraz dostępna pod adresem http://localhost:3000.
Alternatywne metody instalacji
Yarn
Jeśli wolisz używać Yarn zamiast npm:
npm install -g yarn
yarn create next-app my-quantum-apppnpm
pnpm to alternatywny menedżer pakietów, który może zaoszczędzić miejsce na dysku:
npm install -g pnpm
pnpm create next-app my-quantum-appKonfiguracja TypeScript
TypeScript to jak system bezpieczeństwa w Metropolii Quantum - zapobiega błędom przed ich wystąpieniem. Next.js ma wbudowane wsparcie dla TypeScript, a najnowsze wersje create-next-app skonfigurują go automatycznie. Jeśli tworzysz projekt ręcznie, możesz dodać TypeScript później:
touch tsconfig.json
npm run devNext.js wykryje plik tsconfig.json, sam zainstaluje brakujące zależności (typescript, @types/react, @types/node) i uzupełni plik zalecaną konfiguracją.
Struktura projektu Next.js 16 z App Routerem
Po utworzeniu nowego projektu zobaczysz następującą strukturę katalogów:
my-quantum-app/
├── node_modules/ # Zainstalowane zależności
├── public/ # Statyczne pliki (obrazy, czcionki)
├── src/ # Kod źródłowy aplikacji
│ ├── app/ # Katalog App Router
│ │ ├── layout.tsx # Główny układ
│ │ ├── page.tsx # Strona główna
│ │ └── globals.css # Style globalne (tu konfigurujesz też Tailwind CSS 4)
├── AGENTS.md # Wskazówki dla asystentów AI
├── CLAUDE.md # Odsyła do AGENTS.md
├── eslint.config.mjs # Konfiguracja ESLint (format flat config)
├── next-env.d.ts # Typy Next.js dla TypeScript
├── next.config.ts # Konfiguracja Next.js
├── package.json # Zależności i skrypty
├── postcss.config.mjs # Konfiguracja PostCSS (wtyczka Tailwind CSS)
└── tsconfig.json # Konfiguracja TypeScriptW porównaniu ze starszymi wersjami zniknął plik tailwind.config.js: Tailwind CSS 4, który instaluje create-next-app, konfigurujesz bezpośrednio w globals.css. ESLint korzysta z nowego formatu eslint.config.mjs, a konfiguracja Next.js powstaje od razu w TypeScript jako next.config.ts.
Konfiguracja ESLint
ESLint to jak system monitorowania jakości powietrza w Metropolii Quantum - dba o czystość i jakość kodu. create-next-app tworzy podstawową konfigurację ESLint w pliku eslint.config.mjs (format flat config), a skrypt npm run lint uruchamia po prostu polecenie eslint. Next.js 16 usunął dawne polecenie next lint i nie sprawdza już kodu podczas next build, więc lintera uruchamiasz sam. Konfigurację możesz rozszerzyć, np. o Prettiera:
npm install --save-dev eslint-config-prettier eslint-plugin-prettierNastępnie zaktualizuj plik eslint.config.mjs:
// eslint.config.mjs
import { defineConfig, globalIgnores } from 'eslint/config';
import nextVitals from 'eslint-config-next/core-web-vitals';
import nextTs from 'eslint-config-next/typescript';
import prettierRecommended from 'eslint-plugin-prettier/recommended';
const eslintConfig = defineConfig([
...nextVitals,
...nextTs,
{
rules: {
'@typescript-eslint/no-unused-vars': 'warn',
},
},
prettierRecommended,
globalIgnores(['.next/**', 'out/**', 'build/**', 'next-env.d.ts']),
]);
export default eslintConfig;Konfiguracja eslint-plugin-prettier/recommended włącza regułę prettier/prettier i jednocześnie wyłącza reguły ESLinta, które kłóciłyby się z formatowaniem Prettiera, dlatego stoi pod koniec listy. Sprawdzenie całego projektu uruchomisz poleceniem npm run lint.
Konfiguracja Prettier
Prettier to jak automatyczny system organizacji przestrzeni w Metropolii Quantum - dba o spójny wygląd kodu. Utwórz plik .prettierrc w katalogu projektu:
{
"semi": true,
"trailingComma": "all",
"singleQuote": true,
"printWidth": 80,
"tabWidth": 2
}Konfiguracja VSCode dla projektu
Aby edytor VS Code był w pełni zintegrowany z Twoim projektem, utwórz katalog .vscode w katalogu głównym projektu, a następnie plik settings.json wewnątrz:
{
"editor.formatOnSave": true,
"editor.defaultFormatter": "esbenp.prettier-vscode",
"editor.codeActionsOnSave": {
"source.fixAll.eslint": true
},
"typescript.tsdk": "node_modules/typescript/lib",
"typescript.enablePromptUseWorkspaceTsdk": true
}Konfiguracja zmiennych środowiskowych
W Metropolii Quantum każdy system ma swoje specjalne parametry dostępu. W Next.js używamy zmiennych środowiskowych do przechowywania wrażliwych informacji i konfiguracji specyficznych dla środowiska. Utwórz plik .env.local w katalogu głównym projektu:
# Przykładowe zmienne środowiskowe
DATABASE_URL=your_database_url
API_KEY=your_api_key
NEXT_PUBLIC_API_URL=https://api.example.comZmienne z prefiksem NEXT_PUBLIC_ będą dostępne również w przeglądarce.
Testowanie instalacji
Aby upewnić się, że wszystko działa prawidłowo, zmodyfikuj trochę kod w pliku src/app/page.tsx i zobacz, czy zmiany są widoczne w przeglądarce. Jeśli tak, Twoje środowisko jest poprawnie skonfigurowane!
Najczęstsze problemy i rozwiązania
Problem z portami
Jeśli port 3000 jest już zajęty, możesz uruchomić Next.js na innym porcie:
npm run dev -- -p 3001Problemy z Node.js
Jeśli napotkasz błędy związane z kompatybilnością wersji Node.js, upewnij się, że używasz wymaganej wersji:
node -v
# Jeśli wersja jest za stara, zaktualizuj Node.js lub użyj nvmProblemy z TypeScript
Jeśli napotkasz błędy TypeScript, sprawdź, czy masz zainstalowane odpowiednie typy:
npm install --save-dev @types/react @types/nodeZaawansowana konfiguracja
Dla bardziej zaawansowanych projektów, podobnie jak zaawansowane systemy w Metropolii Quantum wymagają dodatkowej konfiguracji, możesz dostosować swoje środowisko Next.js:
Dodanie aliasów ścieżek
Zmodyfikuj tsconfig.json, aby dodać aliasy ścieżek:
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@/components/*": ["src/components/*"],
"@/lib/*": ["src/lib/*"],
"@/styles/*": ["src/styles/*"],
"@/utils/*": ["src/utils/*"]
}
}
}Konfiguracja testów
Dodaj do projektu Jest i React Testing Library:
npm install --save-dev jest @testing-library/react @testing-library/jest-dom jest-environment-jsdomUtwórz plik jest.config.js:
const nextJest = require('next/jest');
const createJestConfig = nextJest({
dir: './',
});
const customJestConfig = {
setupFilesAfterEnv: ['<rootDir>/jest.setup.js'],
testEnvironment: 'jest-environment-jsdom',
};
module.exports = createJestConfig(customJestConfig);Następnie utwórz plik jest.setup.js:
import '@testing-library/jest-dom';Podsumowanie
Gratulacje! Tak jak inżynier w Metropolii Quantum, który ukończył konfigurację swojego stanowiska roboczego, Ty również masz teraz w pełni skonfigurowane środowisko deweloperskie dla Next.js 16. Twoje holograficzne terminale (czyli edytor kodu) są gotowe, reaktor kwantowy (Node.js) jest uruchomiony, a systemy bezpieczeństwa (TypeScript, ESLint) są aktywne.
W następnej lekcji dowiemy się więcej o inicjalizacji projektu i dostępnych starterach, które pozwolą Ci szybciej rozpocząć pracę nad konkretnymi typami aplikacji.
Kod do tej lekcji: index.html
<!DOCTYPE html>
<html lang="pl">
<head>
<meta charset="UTF-8">
<title>Virtual DOM - Metropolis Quantum</title>
<style>
body {
font-family: 'Courier New', monospace;
background: linear-gradient(135deg, #0f0f23 0%, #1a1a2e 100%);
color: #64ffda;
padding: 20px;
margin: 0;
}
.container {
max-width: 800px;
margin: 0 auto;
background: rgba(255, 255, 255, 0.1);
padding: 20px;
border-radius: 10px;
border: 1px solid #64ffda;
}
h1 {
color: #64ffda;
text-align: center;
}
.comparison {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 20px;
margin-top: 20px;
}
.method {
background: rgba(0, 0, 0, 0.5);
padding: 15px;
border-radius: 8px;
border: 2px solid #448aff;
}
.method h3 {
color: #448aff;
margin-top: 0;
}
.demo-box {
background: rgba(100, 255, 218, 0.1);
padding: 10px;
border-radius: 5px;
margin: 10px 0;
border: 1px solid #64ffda;
}
button {
background: linear-gradient(45deg, #7c4dff, #e91e63);
color: white;
border: none;
padding: 10px 20px;
border-radius: 5px;
cursor: pointer;
font-weight: bold;
margin: 5px;
}
button:hover {
transform: scale(1.05);
box-shadow: 0 5px 15px rgba(124, 77, 255, 0.4);
}
</style>
</head>
<body>
<div class="container">
<h1>Virtual DOM a prawdziwy DOM</h1>
<div class="comparison">
<div class="method">
<h3>Tradycyjna manipulacja DOM</h3>
<div id="traditional-demo" class="demo-box">
Licznik: <span id="trad-count">0</span>
</div>
<button onclick="traditionalUpdate()">Aktualizuj (wolno)</button>
<p>Każda zmiana → Pełny re-render strony</p>
</div>
<div class="method">
<h3>Virtual DOM (sposób Reacta)</h3>
<div id="virtual-demo" class="demo-box">
Licznik: <span id="virt-count">0</span>
</div>
<button onclick="virtualUpdate()">Aktualizuj (szybko)</button>
<p>Zmiana → Diff → Tylko niezbędne aktualizacje</p>
</div>
</div>
<div style="margin-top: 30px; background: rgba(124, 77, 255, 0.2); padding: 15px; border-radius: 8px;">
<h3>Jak działa Virtual DOM?</h3>
<ol style="line-height: 1.8;">
<li>React tworzy wirtualną reprezentację DOM w pamięci</li>
<li>Przy zmianie stanu - tworzy nowy Virtual DOM</li>
<li>Porównuje (diffing) stary z nowym Virtual DOM</li>
<li>Aktualizuje tylko zmienione części w prawdziwym DOM</li>
<li>Wynik: Szybsze i bardziej wydajne aplikacje!</li>
</ol>
</div>
</div>
<script>
let tradCount = 0;
let virtCount = 0;
// Tradycyjny DOM - wolniejsza metoda
function traditionalUpdate() {
tradCount++;
console.log("Tradycyjna aktualizacja - cały element jest re-renderowany");
document.getElementById('trad-count').textContent = tradCount;
// Symulacja wolniejszego działania
document.getElementById('traditional-demo').style.background = 'rgba(244, 67, 54, 0.3)';
setTimeout(() => {
document.getElementById('traditional-demo').style.background = 'rgba(100, 255, 218, 0.1)';
}, 200);
}
// Symulacja Virtual DOM - szybsza metoda
function virtualUpdate() {
virtCount++;
console.log("Aktualizacja przez Virtual DOM - tylko niezbędne zmiany");
document.getElementById('virt-count').textContent = virtCount;
// Symulacja szybszego działania
document.getElementById('virtual-demo').style.background = 'rgba(76, 175, 80, 0.3)';
setTimeout(() => {
document.getElementById('virtual-demo').style.background = 'rgba(100, 255, 218, 0.1)';
}, 100);
}
console.log("Demo Virtual DOM - Metropolis Quantum");
console.log("Kliknij przyciski, aby zobaczyć różnicę w działaniu!");
</script>
</body>
</html>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. Next.js został wydany w roku:
2. JSX to:
3. Virtual DOM w React służy do:
Zadania praktyczne w grze
- Układanie w pionie
Ułóż składnię eksportu domyślnego komponentu strony w Next.js