...
Eroare Angular · Angular CLI, build și configurare

Node.js version v18.19.1 detected. The Angular CLI requires a minimum Node.js version of v20.19 or v22.12.

Pe scurt

Versiunea de Node.js instalată e prea veche pentru versiunea de Angular CLI pe care o rulezi. Instalează o versiune LTS suportată (de exemplu cu nvm: nvm install 22 && nvm use 22), apoi rulează din nou npm install și comanda ng.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Fiecare versiune de Angular suportă doar anumite versiuni de Node.js. La pornire, CLI-ul verifică process.version și, dacă e sub minimul cerut, se oprește imediat, înainte de orice compilare. Mesajul spune exact ce a găsit (v18.19.1) și ce minim acceptă.

Se întâmplă de obicei după npm install -g @angular/cli@latest pe un calculator cu Node mai vechi, la clonarea unui proiect nou pe o mașină veche, sau într-un pipeline CI care folosește o imagine Docker cu Node vechi. Uneori apare și invers: un mesaj că versiunea de Node este nesuportată pentru că e prea nouă (o versiune impară sau încă neverificată).

Tabelul de compatibilitate e în documentația Angular (pagina „Version compatibility”); versiunile LTS pare ale Node.js sunt cele recomandate.

De ce apare: cauzele frecvente

1Node vechi pe calculator

Greșit
TypeScript
node -v
# v18.19.1
ng serve
Corect
TypeScript
nvm install 22
nvm use 22
npm install
ng serve

Cu o versiune suportată, verificarea CLI-ului trece; npm install reconstruiește pachetele pentru noul Node.

2Imagine CI cu Node vechi

Greșit
TypeScript
# .github/workflows/build.yml
- uses: actions/setup-node@v4
  with:
    node-version: 18
Corect
TypeScript
- uses: actions/setup-node@v4
  with:
    node-version: 22

Pipeline-ul are propria instalare de Node, separată de calculatorul tău.

3Proiectul nu fixează versiunea

Greșit
TypeScript
# fără .nvmrc sau engines în package.json
Corect
TypeScript
# .nvmrc
22
# package.json
"engines": { "node": "^20.19.0 || ^22.12.0" }

Toată echipa și CI-ul văd aceeași versiune cerută.

Repară tu

Repară eroarea, direct în pagină

După actualizarea lui Node și a lui Angular, proiectul pornește, dar lista de comenzi e goală: componenta folosește încă *ngFor fără importul lui, iar consola arată „Can't bind to 'ngForOf'”. Rescrie lista cu blocul modern @for (cu track c.cod), ca ul#comenzi să aibă 3 rânduri.

Codul care dă eroarea
TypeScript
import { Component } from '@angular/core';

@Component({
  selector: 'app-root',
  template: `
    <ul id="comenzi">
      <li *ngFor="let c of comenzi">{{ c.cod }}: {{ c.total }} lei</li>
    </ul>
  `
})
export class App {
  comenzi = [
    { cod: 'C-201', total: 120 },
    { cod: 'C-202', total: 75 },
    { cod: 'C-203', total: 310 }
  ];
}
Indiciu

Blocurile @for nu au nevoie de niciun import.

Alte forme ale mesajului

  • Node.js version v18.19.1 detected. The Angular CLI requires a minimum Node.js version of v20.19 or v22.12.
  • Node.js version v23.1.0 detected. Odd numbered Node.js versions will not enter LTS status and should not be used for production.

Cum o eviți pe viitor

  • Folosește un manager de versiuni (nvm, fnm, Volta) și un fișier .nvmrc în proiect.
  • Înainte de o actualizare de Angular (ng update), verifică tabelul de compatibilitate și actualizează întâi Node.
  • Ține aceeași versiune de Node local și în CI.
  • Preferă versiunile LTS pare ale Node.js.

Întrebări frecvente

Pot ocoli verificarea?

Nu e recomandat. CLI-ul se oprește pentru că uneltele de build folosesc funcții care lipsesc sau se comportă diferit în versiunile vechi; chiar dacă ai forța pornirea, ai avea erori greu de înțeles mai târziu.

Am schimbat versiunea de Node și acum ng nu mai e găsit. De ce?

Cu nvm, fiecare versiune de Node are pachetele globale separat. Instalează din nou @angular/cli global pentru versiunea nouă sau folosește npx ng.

Erori înrudite

← Toate erorile Angular

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Angular de la zero, cu exerciții la fiecare lecție

Curs Angular: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.