tsconfig.json: Build:No inputs were found in config file — cómo solucionarlo

Introducción: ¿Por qué TypeScript no ve mis archivos?

Abre un proyecto en TypeScript, ejecutas la compilación y, de repente, ¡bam! — un jarro de agua fría con el mensaje: tsconfig.json: Build:No inputs were found in config file. ¿Te suena? Si alguna vez te has enfrentado a la configuración de TypeScript, seguramente has visto este error. Asusta a los principiantes y molesta a los profesionales. Pero no te apresures a arrancarte el cabello o maldecir a Microsoft.

En este artículo, no solo mostraremos cómo silenciar el error rápidamente. Analizaremos su anatomía: por qué ocurre, qué escenarios lo provocan y cómo configurar tsconfig.json para que nunca más veas este mensaje. Será útil tanto para quienes recién comienzan a estudiar TypeScript como para quienes desean comprender más a fondo la mecánica del compilador.

Y sí, hablaremos en español, de forma amena y con ejemplos. ¡Allá vamos!

¿Qué significa el error "Build:No inputs were found in config file"?

Si traducimos del lenguaje del compilador al humano, TypeScript te dice: "No sé qué archivos compilar. Me dijiste que construyera el proyecto, pero no especificaste dónde están los archivos fuente." El compilador tsc busca archivos .ts y .tsx, pero no encuentra ninguno en los directorios que le indicaste (o que él mismo se indicó).

El error ocurre en dos situaciones típicas:

\n
• Acabas de crear tsconfig.json en una carpeta vacía.
\n
• Configuraste incorrectamente los campos include, exclude o rootDir.
\n

Analicemos cada causa en detalle para que no solo copies la solución, sino que entiendas por qué funciona.

Causa n.º 1: No hay archivos TypeScript en el proyecto

La razón más simple, pero común. Creaste tsconfig.json en una carpeta donde no hay ningún archivo .ts. El compilador busca honestamente y no encuentra nada.

Ejemplo del problema:

mi-proyecto/\n├── tsconfig.json\n└── (nada más)

Ejecutamos npx tsc — y obtenemos el error. La solución es obvia: crea al menos un archivo index.ts.

Cómo solucionarlo:

mi-proyecto/\n├── tsconfig.json\n├── src/\n│   └── index.ts   # <-- ¡Aquí está, el salvador!

Pero, ¿qué pasa si los archivos existen y el error sigue apareciendo? Entonces hay que profundizar.

Causa n.º 2: Ruta incorrecta en el campo include

El campo include en tsconfig.json le dice al compilador: "Busca archivos aquí". Si indicaste una carpeta que no existe o te equivocaste en la ruta, el compilador no encontrará nada.

Configuración incorrecta:

{\n  "compilerOptions": {\n    "target": "ES2020",\n    "module": "commonjs",\n    "outDir": "./dist"\n  },\n  "include": ["src/**/*"]  // ¡Y la carpeta src no existe!\n}

En este ejemplo, la carpeta src no existe. El compilador intenta honestamente encontrar archivos con el patrón src/**/*, no encuentra ninguno y muestra el error.

Cómo solucionarlo:

\n
• Verifica que la carpeta que indicaste en include exista.
\n
• Asegúrate de que en esa carpeta haya archivos .ts o .tsx.
\n
• Usa rutas relativas. Si tu tsconfig.json está en la raíz y los archivos fuente en src/, escribe "src/**/*".
\n

Configuración correcta:

{\n  "compilerOptions": {\n    "target": "ES2020",\n    "module": "commonjs",\n    "outDir": "./dist"\n  },\n  "include": ["src/**/*"]\n}\n// Asegúrate de que la carpeta src exista y contenga archivos .ts

Causa n.º 3: Conflicto entre include y exclude

A veces indicas una carpeta en include, pero luego en exclude ex