Error: Cannot find module './calcul'
Node nu găsește fișierul pe care îl ceri cu require: calea e scrisă greșit, fișierul are alt nume sau e în alt dosar. Verifică numele exact al fișierului și calea relativă față de fișierul care face require, de exemplu require("./calcule") sau require("./lib/calcule").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul spune că require a primit un nume de modul și n-a găsit nimic care să i se potrivească. Pentru căile care încep cu ./ sau ../, Node caută un fișier relativ la dosarul fișierului care face require (nu la dosarul din care rulezi node). Încearcă numele exact, apoi cu extensiile .js, .json, .node, apoi un dosar cu index.js.
Sub mesaj apare Require stack: lista fișierelor care au cerut modulul, de jos în sus. Primul rând din listă este fișierul în care trebuie să corectezi calea. La final vezi și code: 'MODULE_NOT_FOUND'.
Cele mai dese cauze: o literă greșită în nume, un dosar uitat din cale, ../ în loc de ./, sau litere mari și mici diferite (pe Linux Calcule.js și calcule.js sunt fișiere diferite).
De ce apare: cauzele frecvente
1Numele fișierului e scris greșit
// fișierul se numește calcule.js
const { totalCos } = require("./calcul");const { totalCos } = require("./calcule");Node caută exact calcul.js, calcul.json sau dosarul calcul/. Niciunul nu există, așa că aruncă eroarea.
2Lipsește dosarul din cale
// proiect/index.js și proiect/lib/calcule.js
const calcule = require("./calcule");const calcule = require("./lib/calcule");Calea relativă pornește din dosarul fișierului curent. Dacă modulul e într-un subdosar, subdosarul trebuie scris în cale.
3Ai uitat ./ în fața numelui
const calcule = require("calcule");const calcule = require("./calcule");Fără ./ sau ../, Node caută un modul inclus (fs, path) sau un pachet din node_modules, nu un fișier din proiect.
4Literele mari și mici nu se potrivesc
// fișierul este Calcule.js
const calcule = require("./calcule");const calcule = require("./Calcule");Pe Windows și macOS merge de obicei, dar pe Linux (servere, Docker) numele sunt sensibile la majuscule și modulul nu mai e găsit.
Repară eroarea, direct în pagină
Programul de mai jos dă Error: Cannot find module './calcul'. Modulul cu funcțiile de calcul există în proiect, dar în alt loc și cu alt nume decât cel cerut. Uită-te la fișierele proiectului și corectează calea din require, ca programul să afișeze totalul coșului și totalul cu TVA.
const { totalCos, cuTva } = require("./calcul");
const cos = [
{ nume: "Cafea", pret: 42, cantitate: 1 },
{ nume: "Lapte", pret: 7.5, cantitate: 2 },
];
const total = totalCos(cos);
console.log(`Total: ${total.toFixed(2)} lei`);
console.log(`Cu TVA: ${cuTva(total).toFixed(2)} lei`);Total: 57.00 lei Cu TVA: 67.83 lei
Indiciu
Fișierul se află în dosarul lib și se numește calcule.js.
Reparația
const { totalCos, cuTva } = require("./lib/calcule");
const cos = [
{ nume: "Cafea", pret: 42, cantitate: 1 },
{ nume: "Lapte", pret: 7.5, cantitate: 2 },
];
const total = totalCos(cos);
console.log(`Total: ${total.toFixed(2)} lei`);
console.log(`Cu TVA: ${cuTva(total).toFixed(2)} lei`);De ce merge
O cale care începe cu ./ e relativă la dosarul fișierului care face require. index.js e în rădăcina proiectului, iar modulul e în lib/calcule.js, deci calea corectă este ./lib/calcule. Extensia .js poate lipsi, pentru că Node o încearcă singur. Cu calea bună, require execută modulul și îți dă obiectul din module.exports, din care iei totalCos și cuTva prin destructurare.
Alte forme ale mesajului
Error: Cannot find module '../config'Error: Cannot find module '/app/index.js'code: 'MODULE_NOT_FOUND'
Cum o eviți pe viitor
- Lasă editorul să completeze calea (autocomplete la
require("./), nu o scrie de mână. - Păstrează numele fișierelor cu litere mici și fără spații.
- Când muți un fișier, caută toate
require-urile care îl folosesc. - Citește
Require stack: îți spune exact ce fișier are calea greșită.
Întrebări frecvente
De ce merge pe calculatorul meu și pe server nu?
Cel mai probabil literele mari și mici diferă. Windows și macOS nu fac diferența între Calcule.js și calcule.js, Linux face. Scrie calea exact ca numele fișierului.
Trebuie să scriu extensia .js?
La require nu: Node încearcă singur .js, .json și index.js dintr-un dosar. La import (module ES) extensia este obligatorie.
Eroarea apare la node index.js, nu la un require. Ce înseamnă?
Atunci Node nu găsește chiar fișierul pe care l-ai dat în comandă: ești în alt dosar decât crezi. Rulează pwd sau ls și pornește node din dosarul proiectului.
Erori înrudite
Error: Cannot find module 'lodash' Pachetul cerut nu este instalat în node_modules: ai uitat npm install, l-ai instalat în alt dosar sau numele e scris greșit. Rulează npm install lodash (sau npm install dacă e deja în package.json) în dosarul proiectului, ori folosește o funcție inclusă în Node. Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/app/utils/preturi.js' imported from /app/index.js Un import dintr-un modul ES arată spre un fișier care nu există: calea e greșită sau lipsește extensia. În modulele ES extensia este obligatorie: import x from "./preturi.js", nu "./preturi". Verifică dosarul și numele fișierului. TypeError: calcule.totalCos is not a function Modulul nu exportă funcția pe care o apelezi, așa că require îți dă un obiect fără ea. Cauza clasică în Node: ai scris exports = { totalCos } în loc de module.exports = { totalCos }, ai uitat exportul sau numele diferă. Exportă cu module.exports. Învață Node.js de la zero, cu exerciții la fiecare lecție
Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
