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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine de la shell (bash, zsh, PowerShell), nu de la Angular: când scrii ng serve, shell-ul caută un program numit ng în folderele din variabila PATH și nu îl găsește.
Angular CLI poate exista în două locuri. Global, instalat cu npm install -g @angular/cli, ca să poți rula ng new oriunde. Local, în node_modules al fiecărui proiect (după npm install), unde e versiunea potrivită proiectului. Comanda ng simplă găsește doar varianta globală; cea locală se rulează cu npx ng ... sau prin scripturile din package.json (npm start = ng serve).
Cauzele tipice: CLI-ul nu a fost instalat global, ai schimbat versiunea de Node (cu nvm, fiecare versiune are pachetele globale separat), sau folderul global al npm nu e în PATH, frecvent pe Windows după instalare, până redeschizi terminalul.
De ce apare: cauzele frecvente
1CLI-ul nu e instalat global
ng new magazin
# bash: ng: command not foundnpm install -g @angular/cli
ng new magazin
# sau, fără instalare globală:
npx @angular/cli new magazinInstalarea globală pune comanda ng în PATH; npx descarcă și rulează CLI-ul o singură dată.
2Proiect clonat, fără CLI global
git clone ... && cd magazin
ng servegit clone ... && cd magazin
npm install
npm start # sau npx ng servenpm install aduce CLI-ul local, în versiunea proiectului, iar npm start / npx îl folosesc pe acela.
3Altă versiune de Node activă (nvm)
nvm use 22
ng version
# ng: command not foundnvm use 22
npm install -g @angular/cliCu nvm, pachetele globale sunt instalate separat pentru fiecare versiune de Node.
Repară eroarea, direct în pagină
În editorul nostru nu există terminal, dar poți exersa ce face ng serve la pornire: rulează main.ts. Fișierul de mai jos importă componenta, dar nu pornește aplicația, deci pagina rămâne goală. Pornește aplicația cu bootstrapApplication(App), ca titlul h1 să apară.
import { bootstrapApplication } from '@angular/platform-browser';
import { App } from './app';
// pornește aplicația aiciIndiciu
Funcția care pornește o aplicație standalone vine din @angular/platform-browser.
Reparația
import { bootstrapApplication } from '@angular/platform-browser';
import { App } from './app';
bootstrapApplication(App).catch((err) => console.error(err));De ce merge
ng serve compilează proiectul și rulează în browser fișierul main.ts. Acolo, bootstrapApplication(App) creează aplicația, caută în index.html elementul <app-root> și randează componenta în el. Fără acest apel, codul se încarcă, dar nimic nu apare pe ecran.
În proiectul tău, după ce comanda ng funcționează (global sau prin npx), exact acest main.ts este punctul de pornire, de obicei cu appConfig ca al doilea argument.
Alte forme ale mesajului
zsh: command not found: ng'ng' is not recognized as an internal or external command, operable program or batch file.ng : The term 'ng' is not recognized as the name of a cmdlet, function, script file, or operable program.
Cum o eviți pe viitor
- În proiecte existente, rulează comenzile prin
npm start,npm run build,npm testsaunpx ng ...: folosesc CLI-ul local, în versiunea corectă. - Instalează global CLI-ul doar pentru
ng newși verifică cung version. - După instalarea Node sau a pachetelor globale pe Windows, deschide un terminal nou.
- Dacă folosești nvm, reinstalează CLI-ul global după schimbarea versiunii de Node.
Întrebări frecvente
E mai bine global sau local?
Local, pentru proiecte: fiecare proiect are versiunea lui de Angular, iar npx ng folosește exact acea versiune. Global e comod pentru ng new și pentru comenzi rapide, dar poate fi altă versiune decât cea a proiectului.
Pe Windows primesc o eroare de execuție a scripturilor în PowerShell. E aceeași problemă?
Nu. Mesajul „running scripts is disabled on this system” înseamnă că PowerShell blochează scriptul ng.ps1. Poți rula din Command Prompt, cu npx ng, sau poți schimba politica de execuție pentru utilizatorul tău.
Erori înrudite
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. Port 4200 is already in use. Would you like to use a different port? (Y/n) Pe portul 4200 rulează deja ceva, de obicei un alt ng serve uitat în alt terminal. Răspunde Y ca să pornești pe alt port, oprește procesul vechi (Ctrl+C sau kill) sau alege explicit portul: ng serve --port 4201. 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. Î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.
