...
Eroare Node.js · Module CommonJS: require și module.exports

Error: Cannot find module './calcul'

Pe scurt

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

Greșit
JavaScript
// fișierul se numește calcule.js
const { totalCos } = require("./calcul");
Corect
JavaScript
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

Greșit
JavaScript
// proiect/index.js și proiect/lib/calcule.js
const calcule = require("./calcule");
Corect
JavaScript
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

Greșit
JavaScript
const calcule = require("calcule");
Corect
JavaScript
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

Greșit
JavaScript
// fișierul este Calcule.js
const calcule = require("./calcule");
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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`);
După reparație, programul afișează
Total: 57.00 lei
Cu TVA: 67.83 lei
Indiciu

Fișierul se află în dosarul lib și se numește calcule.js.

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

← Toate erorile Node.js

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