Kurs JavaScript i React · Moduł 1: Podstawy React

Instalacja Node.js i npm

3 min czytania ·
W tej lekcji6

Zanim zaczniemy korzystać z React, musimy zainstalować podstawowe narzędzia - Node.js i npm (Node Package Manager). To jak przygotowanie zapasów tlenu i paliwa przed wyruszeniem w kosmos.

Czym jest Node.js?

Node.js to platforma, która pozwala uruchamiać JavaScript poza przeglądarką. Tradycyjnie JavaScript był językiem działającym tylko w przeglądarkach, ale Node.js zmienił to, umożliwiając uruchamianie JavaScript również na serwerach i w narzędziach deweloperskich.

Dla dewelopera React, Node.js jest niezbędny do:

  • Uruchamiania lokalnego serwera deweloperskiego
  • Korzystania z menedżera pakietów (npm lub yarn)
  • Budowania i kompilowania aplikacji
  • Uruchamiania narzędzi takich jak lintery, formatery czy testy

Czym jest npm?

npm (Node Package Manager) to największy na świecie rejestr pakietów oprogramowania. To magazyn zawierający miliony pakietów i bibliotek, które możesz dodać do swojego projektu. Wyobraź sobie gigantyczny katalog części zamiennych do statków kosmicznych - cokolwiek potrzebujesz, prawdopodobnie znajdziesz to w npm.

Proces instalacji Node.js i npm

Dla Windows:

  1. Odwiedź oficjalną stronę Node.js
  2. Pobierz wersję LTS (Long-Term Support) - ta wersja jest najbardziej stabilna i zalecana dla większości użytkowników
  3. Uruchom pobrany instalator i postępuj zgodnie z instrukcjami
  4. Instalator automatycznie zainstaluje zarówno Node.js, jak i npm

Dla macOS:

Opcja 1: Instalator

  1. Odwiedź Node.js i pobierz instalator dla macOS
  2. Uruchom instalator i postępuj zgodnie z instrukcjami

Opcja 2: Homebrew (zalecane, jeśli masz już Homebrew)

  1. Otwórz terminal
  2. Wpisz: brew install node

Dla Linux:

Pakiet nodejs z repozytoriów dystrybucji bywa za stary dla Vite (Ubuntu 22.04 instaluje Node 12, Ubuntu 24.04 i Debian 12 - Node 18, a aktualne Vite wymaga Node 20.19 lub nowszego). Najpewniej zainstalujesz aktualną wersję LTS przez nvm (menedżer wersji Node): polecenie instalacji nvm skopiujesz ze strony pobierania nodejs.org (wybierz Linux i nvm), a potem wpiszesz:

nvm install --lts

Weryfikacja instalacji

Po zakończeniu instalacji, otwórz terminal (lub wiersz poleceń) i zweryfikuj instalację, wpisując:

node -v
npm -v

Powinieneś zobaczyć numery wersji, na przykład v22.12.0 dla Node.js i 10.9.0 dla npm (u Ciebie mogą być nowsze). Node.js musi mieć co najmniej wersję 20.19, bo tego wymaga Vite. Jeśli widzisz te informacje, gratulacje! Twój statek kosmiczny jest gotowy do podróży.

Alternatywne menedżery pakietów

Oprócz npm, istnieją również alternatywne menedżery pakietów, które możesz rozważyć:

Yarn

Yarn to menedżer pakietów stworzony przez Facebook, który oferuje szybsze pobieranie pakietów i lepsze zarządzanie zależnościami.

Instalacja:

npm install -g yarn

pnpm

pnpm to wydajny menedżer pakietów, który oszczędza miejsce na dysku, współdzieląc wspólne zależności między projektami.

Instalacja:

npm install -g pnpm

W tym kursie będziemy używać głównie npm, ale wszystkie polecenia mają swoje odpowiedniki w Yarn i pnpm.

Następne kroki

Teraz, gdy masz już zainstalowane Node.js i npm, jesteś gotowy do tworzenia aplikacji React! W następnej lekcji nauczymy się, jak utworzyć nowy projekt React przy użyciu Vite.

Kod do tej lekcji: App.jsx
import React, { useState } from 'react';

// Demonstracja koncepcji npm i zarządzania pakietami w React
function PackageManager() {
  const [packages, setPackages] = useState([
    { name: 'react', version: '19.2.0', description: 'Biblioteka do budowania UI' },
    { name: 'react-dom', version: '19.2.0', description: 'Renderowanie React w przeglądarce' },
    { name: 'axios', version: '1.4.0', description: 'Klient HTTP dla API' },
  ]);

  const [newPackage, setNewPackage] = useState('');

  const installPackage = () => {
    if (newPackage.trim()) {
      setPackages([...packages, {
        name: newPackage,
        version: '1.0.0',
        description: 'Nowo zainstalowany pakiet'
      }]);
      setNewPackage('');
    }
  };

  const removePackage = (name) => {
    setPackages(packages.filter(pkg => pkg.name !== name));
  };

  return (
    <div style={{
      fontFamily: 'Arial, sans-serif',
      maxWidth: '800px',
      margin: '0 auto',
      padding: '20px'
    }}>
      <header style={{
        background: 'linear-gradient(135deg, #667eea 0%, #764ba2 100%)',
        padding: '30px',
        borderRadius: '12px',
        color: 'white',
        textAlign: 'center',
        marginBottom: '30px'
      }}>
        <h1 style={{ margin: 0 }}>NPM Package Manager</h1>
        <p style={{ margin: '10px 0 0 0', opacity: 0.9 }}>
          Symulacja zarządzania pakietami w projekcie React
        </p>
      </header>

      <div style={{
        display: 'flex',
        gap: '10px',
        marginBottom: '20px'
      }}>
        <input
          type="text"
          value={newPackage}
          onChange={(e) => setNewPackage(e.target.value)}
          placeholder="Nazwa pakietu do instalacji..."
          style={{
            flex: 1,
            padding: '12px 15px',
            border: '2px solid #e0e0e0',
            borderRadius: '8px',
            fontSize: '16px'
          }}
        />
        <button
          onClick={installPackage}
          style={{
            padding: '12px 24px',
            backgroundColor: '#4caf50',
            color: 'white',
            border: 'none',
            borderRadius: '8px',
            cursor: 'pointer',
            fontWeight: 'bold'
          }}
        >
          npm install
        </button>
      </div>

      <div style={{
        backgroundColor: '#1e1e1e',
        borderRadius: '8px',
        padding: '15px',
        marginBottom: '20px',
        fontFamily: 'monospace',
        color: '#00ff00'
      }}>
        <div style={{ color: '#888', marginBottom: '5px' }}>$ npm install {newPackage || '<package-name>'}</div>
        <div>added 1 package in 0.5s</div>
      </div>

      <h2 style={{ color: '#333', marginBottom: '15px' }}>
        Zainstalowane pakiety ({packages.length})
      </h2>

      <div style={{ display: 'flex', flexDirection: 'column', gap: '10px' }}>
        {packages.map((pkg, index) => (
          <div key={index} style={{
            display: 'flex',
            alignItems: 'center',
            padding: '15px',
            backgroundColor: '#f8f9fa',
            borderRadius: '8px',
            border: '1px solid #e0e0e0'
          }}>
            <div style={{ flex: 1 }}>
              <div style={{
                fontWeight: 'bold',
                color: '#333',
                marginBottom: '5px'
              }}>
                {pkg.name} <span style={{ color: '#666', fontWeight: 'normal' }}>v{pkg.version}</span>
              </div>
              <div style={{ color: '#666', fontSize: '14px' }}>
                {pkg.description}
              </div>
            </div>
            <button
              onClick={() => removePackage(pkg.name)}
              style={{
                padding: '8px 16px',
                backgroundColor: '#f44336',
                color: 'white',
                border: 'none',
                borderRadius: '4px',
                cursor: 'pointer'
              }}
            >
              Odinstaluj
            </button>
          </div>
        ))}
      </div>

      <div style={{
        marginTop: '30px',
        padding: '20px',
        backgroundColor: '#e3f2fd',
        borderRadius: '8px'
      }}>
        <h3 style={{ color: '#1976d2', marginTop: 0 }}>Podstawowe komendy npm</h3>
        <ul style={{ color: '#333', lineHeight: '1.8' }}>
          <li><code>npm init</code> - Inicjalizacja nowego projektu</li>
          <li><code>npm install</code> - Instalacja wszystkich zależności</li>
          <li><code>npm install nazwa-pakietu</code> - Instalacja konkretnego pakietu</li>
          <li><code>npm uninstall nazwa-pakietu</code> - Odinstalowanie pakietu</li>
          <li><code>npm run dev</code> - Uruchomienie serwera deweloperskiego (projekt Vite)</li>
        </ul>
      </div>
    </div>
  );
}

export default function App() {
  return <PackageManager />;
}

Widzisz błąd w tej lekcji?

Zadania praktyczne w grze

  • Układanie w poziomie

    Ułóż polecenie instalacji pakietu React za pomocą npm:

  • Klikanie w kolejności

    Zbuduj polecenie: przejdź do folderu projektu Vite i uruchom serwer deweloperski:

  • Układanie w pionie

    Ułóż proces instalacji React od zera:

  1. Ułóż w kolejnościInstalacja pakietu npm
  2. Kliknij w kolejnościBudowanie polecenia uruchomienia serwera React
  3. Ułóż w kolejnościProces: Instalacja React

Przydatne artykuły