A Node.js telepítése és beállítása

1Mit telepítünk pontosan?

Egyetlen telepítő három dolgot tesz a gépedre. Sokan azt hiszik, hogy az npm-et külön kell feltenni — nem kell, a Node.js hozza magával.

2Melyik verziót válasszuk?

A Node.js verziószáma három részből áll: major.minor.patch — például 24.20.0. Ez a semver (semantic versioning) rendszer, és nemcsak a Node, hanem minden npm-csomag ezt használja.

LTS vagy Current?

A verziószám előtti jelek — mit enged a ^?

Ez a jelölés a package.json-ban bukkan majd fel, a 8. szakaszban. Érdemes már most megérteni, mert ez dönti el, hogy egy npm install milyen verziót hozhat le:

3Telepítés lépésről lépésre

Válaszd ki a saját operációs rendszeredet — csak azt kell elolvasnod. Ha az iskolai gépen dolgozol, ez a szakasz kimaradhat: ott a környezet már készen áll, ugorj a 4. szakaszra.

winget --version

winget install OpenJS.NodeJS.LTS

Get-AppxPackage -Name Microsoft.DesktopAppInstaller

winget install Schniz.fnm

fnm install 24        # a 24-es LTS telepítése
fnm use 24            # váltás a 24-esre
fnm list              # telepített verziók
fnm default 24        # alapértelmezett verzió

brew install node@24

brew install fnm

eval "$(fnm env --use-on-cd)"

fnm install 24
fnm default 24

# fnm
curl -fsSL https://fnm.vercel.app/install | bash
# új terminál után:
fnm install 24
fnm default 24

# nvm (alternatíva)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
# új terminál után:
nvm install 24
nvm use 24
nvm alias default 24

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

4Telepítés-ellenőrzés

Futtasd le mindet — minden sorra kapnod kell választ. Ha az utolsó parancs kiírja, hogy „Működik a Node!”, a környezeted készen áll.

node -v
npm -v
npx -v
node -p "process.platform + ' / ' + process.arch"
node -e "console.log('Működik a Node!')"

5A parancssor minimuma

Nem kell parancssori mesternek lenned, de ezekre szükséged lesz. A jó hír: a VS Code beépített terminálja mindig a megnyitott projektmappában indul, ezért a mappák közti navigálásra a gyakorlatban alig lesz szükség.

A REPL — interaktív konzol

Ha csak ki akarsz próbálni egy sor JavaScriptet, nem kell fájlt létrehozni:

node
Welcome to Node.js v24.20.0.
Type ".help" for more information.
> 2 + 3
5
> const nev = "Anna"
undefined
> `Szia, ${nev}!`
'Szia, Anna!'
> .exit

Kilépés: .exit vagy kétszer Ctrl + C.

6Az első Node-programod

Hozz létre egy mappát, benne egy elso.js fájlt:

console.log("Szia, Node!");
console.log("Node verzió:", process.version);
console.log("Operációs rendszer:", process.platform);
console.log("Ez a fájl itt van:", import.meta.dirname);

Futtatás:

node elso.js

Amit látnod kell (a saját adataiddal):

Szia, Node!
Node verzió: v24.20.0
Operációs rendszer: win32
Ez a fájl itt van: C:\projektek\proba

Node vs. böngésző — mit ne várj

console.log("ez működik");     // ✅
alert("ez nem");                // ❌ ReferenceError: alert is not defined
document.querySelector("h1");  // ❌ ReferenceError: document is not defined

Nincs window, nincs document, nincs alert — mert nincs weboldal. Cserébe van fájlrendszer, hálózat és folyamatkezelés.

7A projekt: package.json

Egy Node-projekt lelke a package.json fájl. Ez tartja nyilván a projekt nevét, verzióját, a függőségeit és a futtatható parancsait. Minden projekt ezzel kezdődik:

mkdir webshop-api
cd webshop-api
npm init -y

Az -y (yes) minden kérdésre az alapértelmezett választ adja. Ha kérdésekkel szeretnéd: npm init — ekkor sorban rákérdez a névre, verzióra, leírásra.

A létrejött fájl:

{
  "name": "webshop-api",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC"
}

8Csomagok telepítése npm-mel

Az npm (Node Package Manager) egy hatalmas nyilvános csomagtár. Innen tölthetsz le mások által megírt könyvtárakat — az Expresstől a Prismáig mindent.

npm install express            # függőség telepítése (röviden: npm i express)
npm install --save-dev eslint  # fejlesztői függőség (röviden: npm i -D eslint)
npm install                    # a package.json alapján MINDENT telepít
npm uninstall express          # eltávolítás
npm outdated                   # mi az, ami elavult?
npm list --depth=0             # mit telepítettem közvetlenül?

Három dolog keletkezik telepítéskor

npx — futtatás telepítés nélkül

npx prisma init        # a Prisma CLI futtatása telepítés nélkül
npx create-vite@latest # projekt-generátor

Az npx letölti (ideiglenesen), futtatja, majd nem hagy maga után szemetet. Egyszer használatos eszközökhöz — például projekt-generátorokhoz — ez az ideális.

9Saját parancsok: scripts

A package.json scripts szakaszába saját parancsokat írhatsz. Ennek az az értelme, hogy a hosszú parancsot egyszer írod le, és utána mindenki ugyanazt a rövid nevet használja:

"scripts": {
  "start": "node index.js",
  "dev": "node --watch --env-file=.env index.js",
  "test": "node --test"
}

Futtatásuk:

npm start        # a "start" külön kezelt: nem kell a "run"
npm run dev
npm test
npm run          # kilistázza az elérhető parancsokat

Automatikus újraindítás fejlesztés közben

Régen ehhez a nodemon csomag kellett. Ma már beépített:

node --watch index.js

A Node figyeli a fájlokat, és mentés után automatikusan újraindítja a programot. Ezért lesz a dev scriptünk mindig ez.

Környezeti változók fájlból

node --env-file=.env index.js

A .env fájl sorai (KULCS=érték) bekerülnek a process.env objektumba:

# .env
PORT=3000
DATABASE_URL="mysql://root:jelszo@localhost:3306/webshop"

console.log(process.env.PORT);   // 3000

node_modules/
.env

10CommonJS vagy ESM?

A Node.js-ben kétféle modulrendszer él egymás mellett. Fontos tudni, melyiket használod, mert az interneten talált példák felváltva mutatják mindkettőt — és ha összekevered őket, a program el sem indul.

Mi ESM-et használunk, mert ez a szabvány, és ezt ismered a frontendről is. Ehhez a package.json-ba fel kell venni:

{
  "name": "webshop-api",
  "type": "module",
  "main": "index.js"
}

Példa két fájlra:

// matek.js
export function osszead(a, b) {
  return a + b;
}
export const PI = 3.14159;

// index.js
import { osszead, PI } from "./matek.js";   // ⚠️ a .js kiterjesztés KÖTELEZŐ!
console.log(osszead(2, 3));                 // 5

Az ESM-fájlokban az útvonalhoz nem a régi __dirname, hanem ez használható:

console.log(import.meta.dirname);   // a fájl mappája
console.log(import.meta.filename);  // a fájl teljes útvonala

11Gyakorlat: projekt a nulláról

Csináld végig, és minden lépésnél ellenőrizd a jelzett eredményt. Ez lesz a minta minden későbbi projekthez.

1. Mappa létrehozása és belépés

   mkdir node-proba
   cd node-proba

2. Projekt inicializálása

   npm init -y

   Ellenőrzés: létrejött a package.json.
3. ESM bekapcsolása. Nyisd meg a package.json-t, és vedd fel a "type": "module" sort.
4. Scriptek beállítása

   "scripts": {
     "start": "node index.js",
     "dev": "node --watch index.js"
   }

5. Az index.js létrehozása

   const tanulok = ["Anna", "Bence", "Csenge"];
   
   console.log("Node verzió:", process.version);
   console.log("Tanulók száma:", tanulok.length);
   
   for (const nev of tanulok) {
     console.log(`- ${nev}`);
   }

6. Futtatás

   npm start

7. Figyelő mód

   npm run dev

   Ellenőrzés: írj át valamit a fájlban, majd ments (Ctrl + S). A program magától újraindul. Leállítás: Ctrl + C.
8. Egy csomag telepítése próbaképpen

   npm install express

   Ellenőrzés: megjelent a node_modules mappa, a package-lock.json fájl, és a package.json-ban a dependencies szakasz.

12Gyakori hibák

Összefoglaló táblázat

13Feladatok

// a package.json-ban nincs "type" mező
import express from "express";

// a package.json-ban van "type": "module"
import { osszead } from "./matek";

14Önellenőrző kvíz

15Összegzés

16Fogalomtár