Lingua-e
← Errores
JavaScript

Qué significa TS2307: Cannot Find Module y cómo solucionarlo

Referencia del error

TS2307: Cannot Find Module

Lenguaje

JavaScript

Severidad

Alta

Cuándo ocurre

El error TS2307 de TypeScript se reporta cuando no se puede resolver una importación de módulo.

Posibles soluciones

Ejecuta npm install para el paquete faltante. Instala @types/nombre-paquete si el paquete carece de tipos integrados. Para importaciones relativas, verifica la ruta del archivo y la extensión. Comprueba moduleResolution: 'bundler' o 'node16' en tsconfig.json para paquetes modernos.

Más detalles

El error TS2307 de TypeScript se reporta cuando no se puede resolver una importación de módulo. Esto ocurre cuando el paquete no está instalado, la ruta es incorrecta o el paquete carece de declaraciones de tipos TypeScript.

Por qué ocurre

  • El paquete npm se referencia pero no está instalado (falta en node_modules).
  • El paquete existe pero no tiene declaraciones de tipos y no tiene un @types correspondiente.
  • Una importación de ruta relativa tiene un error tipográfico o apunta a un archivo que no existe.
  • La configuración moduleResolution en tsconfig.json es incompatible con el campo exports del paquete.

Posibles soluciones

Ejecuta npm install para el paquete faltante. Instala @types/nombre-paquete si el paquete carece de tipos integrados. Para importaciones relativas, verifica la ruta del archivo y la extensión. Comprueba moduleResolution: 'bundler' o 'node16' en tsconfig.json para paquetes modernos.

Ejemplos

JavaScript

Código que causa el error

import { format } from "date-fns";

Error en la terminal

error TS2307: Cannot find module 'date-fns' or its corresponding type declarations.

Código corregido

// First install the package
// npm install date-fns
import { format } from "date-fns";

Practica en inglés

¿Cómo le explicarías un TS2307: Cannot Find Module a un compañero dev? Elige la frase correcta:

"I hit an error...

¿Listo para practicar tu inglés en el trabajo?

Lingua-e tiene ejercicios interactivos basados en conversaciones reales de developers: standups, code reviews, retrospectivas y más. Practica hasta que salga solo.

Prueba Lingua-e gratis