Capitol gratuit

Instalare, npm și package.json

Metoda 1: nvm-windows (recomandată) nvm-windows permite instalarea și comutarea între mai multe versiuni de Node.js pe același calculator - util atunci cân...

Instalare pe Windows

Metoda 1: nvm-windows (recomandată)

nvm-windows permite instalarea și comutarea între mai multe versiuni de Node.js pe același calculator - util atunci când lucrați la proiecte diferite, cu cerințe diferite.

# Descărcați installer-ul de la:
# github.com/coreybutler/nvm-windows/releases

# După instalare, în terminal:
nvm install lts
nvm list
nvm use 24.0.0

Metoda 2: Installer oficial

Descărcați installer-ul .msi direct de la nodejs.org și alegeți versiunea LTS (Long Term Support), recomandată pentru majoritatea proiectelor.

Metoda 3: WinGet

winget install OpenJS.NodeJS.LTS

Verificare instalare

node --version
npm --version
Sfat: Alegeți întotdeauna versiunea LTS (Active LTS) pentru proiecte de producție. Versiunile „Current" primesc funcționalități noi mai repede, dar sunt mai puțin stabile pentru producție.

package.json - fișierul de configurare

Fiecare proiect Node.js are un fișier package.json care descrie proiectul, dependențele și comenzile disponibile.

npm init          # întrebări interactive
npm init -y       # generează cu valorile implicite
{
"name": "aplicatie-goai",
"version": "1.0.0",
"description": "API REST pentru gestiunea comenzilor",
"main": "src/server.js",
"type": "module",
"engines": {
"node": ">=22.0.0"
},
"scripts": {
"start": "node src/server.js",
"dev": "node --watch src/server.js",
"test": "node --test",
"build": "tsc -p ."
},
"dependencies": {
"express": "^5.2.1",
"dotenv": "^16.4.5"
},
"devDependencies": {
"nodemon": "^3.1.0"
}
}

Comenzi npm esențiale

ComandăDescriere
npm installInstalează toate dependențele din package.json
npm install expressAdaugă un pachet ca dependență de producție
npm install -D nodemonAdaugă un pachet ca dependență de dezvoltare
npm uninstall expressElimină un pachet
npm updateActualizează pachetele la ultima versiune compatibilă
npm outdatedArată pachetele care au versiuni mai noi disponibile
npm run devRulează scriptul „dev" din package.json
npx cowsay helloExecută un pachet fără instalare permanentă
npm auditVerifică vulnerabilități de securitate în dependențe
npm ciInstalare curată, exactă, bazată pe package-lock.json (recomandat în CI/CD)

Semantic Versioning (SemVer)

Versiunile pachetelor npm urmează formatul MAJOR.MINOR.PATCH (ex: 5.2.1):

SimbolExempluSemnificație
^^5.2.1Acceptă actualizări minore și patch-uri (5.x.x, nu 6.0.0)
~~5.2.1Acceptă doar patch-uri (5.2.x)
(fără simbol)5.2.1Versiune exactă, fără actualizări automate
**Orice versiune (nerecomandat)

package-lock.json

Fișierul package-lock.json înregistrează exact versiunile instalate ale tuturor dependențelor (inclusiv dependențele dependențelor). Trebuie întotdeauna comis în git, pentru ca toată echipa și serverul de producție să folosească exact aceleași versiuni.

Atenție: Nu adăugați folderul node_modules în git. Folosiți un fișier .gitignore cu linia node_modules/. Folderul se regenerează oricând cu npm install.

Alternative la npm

ManagerAvantaje
npmVine implicit cu Node.js, cel mai folosit, documentație vastă
pnpmMult mai rapid, economisește spațiu pe disc prin symlink-uri și un store partajat
yarnInstalare paralelă, workspaces pentru monorepo-uri

Continuați cu restul cursului

Acesta este capitolul 2 din cele 14 ale cursului, cu 6 lecții din 85. Cumpărați cursul și parcurgeți tot conținutul în cont, cu progres salvat, test final și certificat.

Cumpărați cursul la 110 €