error TS2307: Cannot find module 'lodash' or its corresponding type declarations.
TypeScript nu găsește modulul importat: pachetul nu e instalat, nu are tipuri, calea relativă e greșită sau rulezi într-un mediu fără module. Instalează pachetul (și @types/<pachet> dacă e nevoie), corectează calea sau, într-un singur fișier, scrie funcția local.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Pentru fiecare import ... from "x", TypeScript caută modulul: în node_modules pentru numele de pachete, relativ la fișierul curent pentru căile care încep cu ./ sau ../. Dacă nu găsește nici codul, nici declarațiile de tip (.d.ts), dă TS2307.
Cauze frecvente: pachetul nu e instalat (npm install uitat), pachetul e instalat, dar nu are tipuri proprii și lipsește @types/<pachet> (de exemplu @types/lodash), calea relativă e greșită (./utils în loc de ../utils, majuscule diferite), lipsesc setările moduleResolution sau paths pentru alias-uri (@/components), ori importi fișiere non-TS (.css, .svg) fără o declarație declare module.
În editorul nostru, programul e un singur fișier fără pachete, deci orice import dă eroarea asta. Scrie direct în program funcțiile de care ai nevoie.
De ce apare: cauzele frecvente
1Pachet neinstalat sau fără tipuri
import _ from "lodash";// npm i lodash
// npm i -D @types/lodash
import _ from "lodash";Codul pachetului vine din lodash, iar tipurile din @types/lodash.
2Cale relativă greșită
// fișierul: src/pagini/acasa.ts
import { formateaza } from "./utils/format";// fișierul: src/pagini/acasa.ts
import { formateaza } from "../utils/format";Calea relativă pornește din folderul fișierului care face importul.
3Fișier non-TypeScript fără declarație
import logo from "./logo.svg";// global.d.ts
declare module "*.svg" {
const url: string;
export default url;
}Pentru resurse importate prin bundler, o declarație declare module spune ce tip are importul.
Repară eroarea, direct în pagină
Codul de mai jos dă eroarea TS2307: Cannot find module 'lodash' or its corresponding type declarations, pentru că editorul nu are pachete. Scoate importul și scrie o funcție proprie sumBy, ca programul să afișeze Total comandă: 57 lei.
import { sumBy } from "lodash";
interface Linie {
produs: string;
pret: number;
buc: number;
}
const linii: Linie[] = [
{ produs: "Cafea", pret: 21, buc: 2 },
{ produs: "Lapte", pret: 7.5, buc: 2 },
];
const total = sumBy(linii, (l: Linie) => l.pret * l.buc);
console.log(`Total comandă: ${total} lei`);Total comandă: 57 lei
Indiciu
sumBy(lista, f) adună rezultatele lui f pentru fiecare element; o poți scrie cu reduce.
Reparația
function sumBy<T>(lista: T[], f: (x: T) => number): number {
return lista.reduce((s, x) => s + f(x), 0);
}
interface Linie {
produs: string;
pret: number;
buc: number;
}
const linii: Linie[] = [
{ produs: "Cafea", pret: 21, buc: 2 },
{ produs: "Lapte", pret: 7.5, buc: 2 },
];
const total = sumBy(linii, (l) => l.pret * l.buc);
console.log(`Total comandă: ${total} lei`);De ce merge
TypeScript caută modulul lodash în node_modules, dar editorul rulează un singur fișier, fără pachete, deci importul nu poate fi rezolvat. Într-un proiect real ai instala lodash și @types/lodash. Aici, funcția generică sumBy face același lucru în trei rânduri: reduce pornește de la 0 și adaugă f(x) pentru fiecare linie. Tipul T e dedus ca Linie, deci în callback l.pret și l.buc sunt verificate: 42 + 15 = 57.
Alte forme ale mesajului
error TS7016: Could not find a declaration file for module 'lodash'. '/proiect/node_modules/lodash/lodash.js' implicitly has an 'any' type.
Cum o eviți pe viitor
- După
git clonesau schimbarea branch-ului, ruleazănpm install. - La pachetele fără tipuri proprii, instalează
@types/<pachet>ca dependență de dezvoltare. - Folosește căile sugerate de autocomplete la
importși configurează alias-urile o singură dată, în tsconfig. - Verifică numele pachetului în package.json înainte să-l imporți.
Întrebări frecvente
Pachetul e instalat și tot primesc eroarea. Ce verific?
Dacă are tipuri (caută types în package.json-ul lui sau pachetul @types/...), dacă moduleResolution din tsconfig se potrivește proiectului (bundler sau node16) și repornește serverul TypeScript din editor.
E la fel cu „Could not find a declaration file for module”?
E ruda ei, TS7016: modulul există, dar fără tipuri, iar în strict el ar fi any implicit. Reparația e tot @types/<pachet> sau o declarație declare module.
Erori înrudite
error TS2591: Cannot find name 'require'. Do you need to install type definitions for node? Try `npm i --save-dev @types/node` and then add 'node' to the types field in your tsconfig. TypeScript nu cunoaște require (sau process, __dirname, Buffer) pentru că lipsesc tipurile pentru Node. Într-un proiect Node instalează @types/node și adaugă "node" la types în tsconfig; în editorul din browser nu există Node, deci scrii codul fără require. error TS2584: Cannot find name 'document'. Do you need to change your target library? Try changing the 'lib' compiler option to include 'dom'. TypeScript nu are tipurile pentru browser (DOM), deci nu cunoaște document, window sau HTMLElement. Într-un proiect web adaugă "dom" la lib în tsconfig; dacă rulezi în Node sau într-o consolă (ca editorul nostru), nu există DOM și folosești console.log. error TS2304: Cannot find name 'totl'. Folosești un nume (variabilă, funcție, tip) pe care TypeScript nu-l găsește nicăieri în scope. De obicei e o greșeală de scriere, o variabilă declarată în alt bloc sau ceva ce nu există în mediul tău; corectează numele sau declară-l înainte. Învață TypeScript de la zero, cu exerciții la fiecare lecție
Curs TypeScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
