...
Eroare TypeScript · Mediu, biblioteci și module

error TS2307: Cannot find module 'lodash' or its corresponding type declarations.

Pe scurt

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

Greșit
TypeScript
import _ from "lodash";
Corect
TypeScript
// 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ă

Greșit
TypeScript
// fișierul: src/pagini/acasa.ts
import { formateaza } from "./utils/format";
Corect
TypeScript
// 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

Greșit
TypeScript
import logo from "./logo.svg";
Corect
TypeScript
// 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ă tu

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.

Codul care dă eroarea
TypeScript
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`);
După reparație, programul afișează
Total comandă: 57 lei
Indiciu

sumBy(lista, f) adună rezultatele lui f pentru fiecare element; o poți scrie cu reduce.

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 clone sau 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

← Toate erorile TypeScript

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