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

bash: ng: command not found

Pe scurt

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

Greșit
TypeScript
ng new magazin
# bash: ng: command not found
Corect
TypeScript
npm install -g @angular/cli
ng new magazin
# sau, fără instalare globală:
npx @angular/cli new magazin

Instalarea globală pune comanda ng în PATH; npx descarcă și rulează CLI-ul o singură dată.

2Proiect clonat, fără CLI global

Greșit
TypeScript
git clone ... && cd magazin
ng serve
Corect
TypeScript
git clone ... && cd magazin
npm install
npm start   # sau npx ng serve

npm install aduce CLI-ul local, în versiunea proiectului, iar npm start / npx îl folosesc pe acela.

3Altă versiune de Node activă (nvm)

Greșit
TypeScript
nvm use 22
ng version
# ng: command not found
Corect
TypeScript
nvm use 22
npm install -g @angular/cli

Cu nvm, pachetele globale sunt instalate separat pentru fiecare versiune de Node.

Repară tu

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ă.

Codul care dă eroarea
TypeScript
import { bootstrapApplication } from '@angular/platform-browser';
import { App } from './app';

// pornește aplicația aici
Indiciu

Funcția care pornește o aplicație standalone vine din @angular/platform-browser.

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 test sau npx ng ...: folosesc CLI-ul local, în versiunea corectă.
  • Instalează global CLI-ul doar pentru ng new și verifică cu ng 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

← 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.