Node.js version v18.19.1 detected. The Angular CLI requires a minimum Node.js version of v20.19 or v22.12.
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
node -v
# v18.19.1
ng servenvm install 22
nvm use 22
npm install
ng serveCu o versiune suportată, verificarea CLI-ului trece; npm install reconstruiește pachetele pentru noul Node.
2Imagine CI cu Node vechi
# .github/workflows/build.yml
- uses: actions/setup-node@v4
with:
node-version: 18- uses: actions/setup-node@v4
with:
node-version: 22Pipeline-ul are propria instalare de Node, separată de calculatorul tău.
3Proiectul nu fixează versiunea
# fără .nvmrc sau engines în package.json# .nvmrc
22
# package.json
"engines": { "node": "^20.19.0 || ^22.12.0" }Toată echipa și CI-ul văd aceeași versiune cerută.
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.
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.
Reparația
import { Component } from '@angular/core';
@Component({
selector: 'app-root',
template: `
<ul id="comenzi">
@for (c of comenzi; track c.cod) {
<li>{{ 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 }
];
}De ce merge
*ngFor este o directivă din @angular/common care trebuie importată în componentă (NgFor sau CommonModule). Fără import, Angular nu știe ce e ngForOf, afișează NG0303, iar elementul li nu e repetat deloc.
Blocul @for (c of comenzi; track c.cod) face parte din sintaxa șablonului din Angular 17, deci merge fără import, iar track spune cum se recunosc rândurile. Actualizările de versiune sunt un moment bun pentru astfel de modernizări (ng generate @angular/core:control-flow).
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
bash: ng: command not found Terminalul nu găsește comanda ng: Angular CLI nu e instalat global sau folderul cu programele npm nu e în PATH. Rulează comanda prin npx (npx ng serve), prin scripturile proiectului (npm start) sau instalează CLI-ul global: npm install -g @angular/cli. Schema validation failed with the following errors: Data path "" must NOT have additional properties(browserTarget). angular.json conține o opțiune pe care builder-ul folosit nu o mai acceptă (aici browserTarget, redenumită buildTarget). Redenumește sau șterge opțiunea din paranteză, sau rulează ng update, care face migrările automat. [ERROR] Could not resolve "lodash" Builder-ul Angular (esbuild) nu găsește pachetul importat: nu e instalat, numele e greșit sau importul are o cale relativă greșită. Rulează npm install <pachet> (sau npm install după clonare), corectează calea, ori înlocuiește biblioteca cu cod propriu. Î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.
