TS2307: Cannot find module '@angular/material/button' or its corresponding type declarations.
Importezi dintr-un pachet care nu e instalat în proiect (aici Angular Material). Instalează-l cu ng add @angular/material (sau npm install), verifică numele importului, sau renunță la el dacă nu ai nevoie.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
TS2307 este eroarea TypeScript pentru „nu găsesc modulul”. La ng build / ng serve, compilatorul caută @angular/material/button în node_modules și nu găsește nici codul, nici tipurile. Build-ul se oprește și arată fișierul și linia importului.
Cauzele obișnuite: pachetul nu a fost instalat (ai copiat cod dintr-un tutorial sau dintr-un alt proiect), npm install nu a fost rulat după clonare sau după schimbarea ramurii git, numele e scris greșit, sau versiunea instalată nu are calea importată.
Pentru Angular Material, CDK și alte biblioteci oficiale, varianta recomandată este ng add, care instalează versiunea compatibilă cu Angular-ul tău și face configurarea inițială (temă, animații, fonturi).
De ce apare: cauzele frecvente
1Pachetul nu e instalat
import { MatButtonModule } from '@angular/material/button';
// @angular/material lipsește din package.jsonng add @angular/material
# apoi importul funcționeazăng add instalează pachetul compatibil și îl adaugă în package.json.
2Dependențele nu au fost instalate
git pull
ng servegit pull
npm install
ng serveDacă un coleg a adăugat un pachet, package.json se schimbă, dar node_modules se actualizează doar după npm install.
3Cale de import greșită
import { MatButtonModule } from '@angular/material';import { MatButtonModule } from '@angular/material/button';Angular Material se importă pe componente, din subcăi; rădăcina pachetului nu exportă modulele.
Repară eroarea, direct în pagină
Componenta importă MatButtonModule din @angular/material/button, pachet care nu e instalat (și nici disponibil în editorul nostru), iar aplicația se oprește cu „Cannot find module '@angular/material/button'”. Renunță la Material: un buton simplu cu clasa buton-principal, iar după click pe #adauga, p#cos să afișeze „Produse în coș: 1”.
import { Component, signal } from '@angular/core';
import { MatButtonModule } from '@angular/material/button';
@Component({
selector: 'app-root',
imports: [MatButtonModule],
template: `
<button mat-raised-button id="adauga" (click)="cos.update((n) => n + 1)">Adaugă în coș</button>
<p id="cos">Produse în coș: {{ cos() }}</p>
`
})
export class App {
cos = signal(0);
}Indiciu
Fără pachet, scoate și importul, și folosirea lui din imports și din șablon.
Reparația
import { Component, signal } from '@angular/core';
@Component({
selector: 'app-root',
template: `
<button class="buton-principal" id="adauga" (click)="cos.update((n) => n + 1)">Adaugă în coș</button>
<p id="cos">Produse în coș: {{ cos() }}</p>
`,
styles: `.buton-principal { background: #3f51b5; color: white; border: 0; padding: 8px 16px; border-radius: 4px; }`
})
export class App {
cos = signal(0);
}De ce merge
Un import dintr-un pachet care nu există în node_modules oprește compilarea (TS2307 la ng build) sau încărcarea aplicației (aici). Cât timp linia de import rămâne, nimic nu rulează.
Într-un proiect real ai două variante: instalezi pachetul (ng add @angular/material) sau renunți la el. Aici am ales a doua: butonul HTML obișnuit cu o clasă CSS face aceeași treabă, iar componenta nu mai depinde de un pachet lipsă.
Alte forme ale mesajului
error TS2307: Cannot find module '@angular/material/button' or its corresponding type declarations.[ERROR] TS2307: Cannot find module '@angular/material/button' or its corresponding type declarations. [plugin angular-compiler]Cannot find module '@angular/material/button'
Cum o eviți pe viitor
- Rulează
npm installdupă fiecare clonare,git pullsau schimbare de ramură care modificăpackage.json. - Instalează bibliotecile oficiale Angular cu
ng add, nu doar cunpm install. - Când copiezi cod, verifică la început lista de importuri și ce pachete presupune.
- Folosește importuri din calea documentată a bibliotecii.
Întrebări frecvente
Am instalat pachetul și eroarea a rămas. De ce?
Oprește și repornește ng serve: unele modificări din node_modules nu sunt observate de serverul pornit. Verifică apoi că pachetul apare în package.json și că versiunea lui e compatibilă cu Angular-ul tău.
Care e diferența dintre TS2307 și Could not resolve?
TS2307 vine de la TypeScript (nu găsește tipurile), iar „Could not resolve” vine de la esbuild, când împachetează codul. Cauza e de obicei aceeași: pachetul lipsește sau calea e greșită.
Erori înrudite
[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. [ERROR] bundle initial exceeded maximum budget. Budget 1.00 MB was not met by 312.45 kB with a total of 1.31 MB. Codul încărcat la pornirea aplicației (bundle-ul inițial) a depășit limita din budgets în angular.json, iar ng build se oprește. Încarcă paginile grele leneș (loadComponent, @defer), scoate bibliotecile mari neutilizate sau, dacă e justificat, mărește limita. 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. Î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.
