TS2307: Cannot find module './card' or its corresponding type declarations.
Calea din import nu duce la niciun fișier: fișierul e în alt folder, are alt nume (card.component.ts) sau ai greșit ./ și ../. Corectează calea relativă, fără extensia .ts: import { Card } from './components/card';
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Importurile care încep cu ./ sau ../ sunt căi relative față de fișierul în care scrii. ./card înseamnă „fișierul card.ts din același folder”. Dacă acolo nu există, TypeScript raportează TS2307: Cannot find module './card', iar build-ul se oprește; în browser (în modul de dezvoltare) vezi „Cannot find module” sau, cu Vite/esbuild, „Could not resolve "./card"”.
Partea „or its corresponding type declarations” contează la pachetele npm (lipsește pachetul sau tipurile lui). Pentru fișierele tale, problema e aproape mereu calea.
Cauze tipice în Angular: convenția de nume s-a schimbat (Angular 20 generează card.ts, versiunile vechi card.component.ts), componenta e într-un subfolder (components/card), ai mutat fișierul, sau ai scris ../ în loc de ./.
De ce apare: cauzele frecvente
1Fișierul e într-un subfolder
// app.ts, fișierul e în components/card.ts
import { Card } from './card';import { Card } from './components/card';Calea relativă trebuie să includă folderele de pe drum.
2Nume de fișier după altă convenție
// fișierul se numește card.component.ts
import { Card } from './card';import { CardComponent } from './card.component';Numele din import trebuie să fie numele real al fișierului (fără .ts).
3Nivel de folder greșit
// în src/app/pagini/acasa.ts
import { Card } from './card';// în src/app/pagini/acasa.ts
import { Card } from '../card';../ urcă un folder: din pagini/ ajungi în app/, unde e card.ts.
Repară eroarea, direct în pagină
Componenta Card se află în fișierul components/card.ts, dar app.ts o importă din ./card și aplicația dă eroarea „Cannot find module './card'”. Repară calea importului ca pagina să afișeze cardul cu textul „Monitor 27 inch”.
import { Component } from '@angular/core';
import { Card } from './card';
@Component({
selector: 'app-root',
imports: [Card],
template: `<app-card />`
})
export class App {}Indiciu
Calea relativă trebuie să includă folderul components.
Reparația
import { Component } from '@angular/core';
import { Card } from './components/card';
@Component({
selector: 'app-root',
imports: [Card],
template: `<app-card />`
})
export class App {}De ce merge
./card înseamnă fișierul card.ts din același folder cu app.ts. Acolo nu există, pentru că fișierul e în components/, deci modulul nu poate fi găsit și aplicația nu pornește.
Cu ./components/card, calea duce exact la fișier: Card e importată, pusă în imports, iar <app-card> afișează textul ei.
Alte forme ale mesajului
Cannot find module './card'error TS2307: Cannot find module './card.component' or its corresponding type declarations.X [ERROR] Could not resolve "./card"Module not found: Error: Can't resolve './card' in '/src/app'
Cum o eviți pe viitor
- Lasă editorul să scrie importurile (auto-import în VS Code), în loc să le tastezi de mână.
- Când muți sau redenumești fișiere, fă-o din editor: actualizează automat importurile.
- Păstrează o singură convenție de nume în proiect (
card.tssaucard.component.ts). - Pentru căi lungi (
../../../), configurează alias-uri întsconfig.json(paths).
Întrebări frecvente
Trebuie să scriu extensia .ts în import?
Nu. Importurile TypeScript se scriu fără extensie: ./card, nu ./card.ts.
Calea e corectă și tot primesc eroarea. Ce verific?
Litere mari și mici (pe Linux și în CI, Card.ts și card.ts sunt fișiere diferite), un fișier salvat în alt folder decât crezi și repornirea ng serve după ce ai mutat fișiere.
Erori înrudite
TS2305: Module '"./card"' has no exported member 'Kard'. Fișierul importat există, dar nu exportă numele cerut: clasa se numește altfel (Card, CardComponent), lipsește cuvântul export sau e export default. Importă exact numele exportat: import { Card } from './card'; NG0304: 'app-card' is not a known element (used in the 'App' component template) Șablonul folosește tagul <app-card>, dar componenta care are acest selector nu e în imports-ul componentei curente (sau selectorul e scris diferit). Importă clasa și adaug-o în imports: [Card] din @Component. The "Card" component, imported from "App", is not standalone. Does the component have the standalone: false flag? În imports-ul unei componente standalone ai pus o componentă declarată cu standalone: false (care aparține unui NgModule). Fă-o standalone (șterge standalone: false) sau importă NgModule-ul care o exportă. Î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.
