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

TS2307: Cannot find module '@angular/material/button' or its corresponding type declarations.

Pe scurt

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

Greșit
TypeScript
import { MatButtonModule } from '@angular/material/button';
// @angular/material lipsește din package.json
Corect
TypeScript
ng add @angular/material
# apoi importul funcționează

ng add instalează pachetul compatibil și îl adaugă în package.json.

2Dependențele nu au fost instalate

Greșit
TypeScript
git pull
ng serve
Corect
TypeScript
git pull
npm install
ng serve

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

Greșit
TypeScript
import { MatButtonModule } from '@angular/material';
Corect
TypeScript
import { MatButtonModule } from '@angular/material/button';

Angular Material se importă pe componente, din subcăi; rădăcina pachetului nu exportă modulele.

Repară tu

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

Codul care dă eroarea
TypeScript
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.

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 install după fiecare clonare, git pull sau schimbare de ramură care modifică package.json.
  • Instalează bibliotecile oficiale Angular cu ng add, nu doar cu npm 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

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