2. Configuración Profesional de tsconfig.json: Modo Estricto, Target y Rutas Modulares
Domina las directivas esenciales del compilador: strict: true, noImplicitAny, target, moduleResolution, lib, outDir y el mapeo de alias de rutas con paths.
El Corazón del Proyecto: tsconfig.json
El archivo tsconfig.json en la raíz de tu proyecto le indica a tsc y a tu editor cómo interpretar el código fuente, qué versión de JavaScript generar como salida (target), qué librerías del entorno incluir (DOM o Node) y qué tan rigurosas deben ser las comprobaciones de seguridad de tipos.
1. La Bandera Suprema: "strict": true
En proyectos serios, activar "strict": true es innegociable. Esta directiva agrupa las comprobaciones más críticas de TypeScript:
noImplicitAny: Prohíbe que variables o parámetros queden implícitamente tipados comoanycuando TypeScript no pueda inferir su tipo.strictNullChecks: Obliga a contemplar explícitamente valoresnullyundefined, evitando el temido error "Cannot read properties of undefined".strictFunctionTypes: Garantiza que los parámetros de funciones se verifiquen contravariablemente.useUnknownInCatchVariables: Hace que la variable del bloquecatch (err)sea de tipounknownen lugar deany, forzando a verificar si es una instancia deErrorantes de acceder aerr.message.
2. Alias de Rutas con "paths" (Dile adiós a ../../../)
En lugar de escribir rutas relativas frágiles como import { Auth } from '../../../core/auth', configuramos baseUrl y paths para usar prefijos limpios como @/core/auth o @models/user.
⚡ Plantilla Profesional de tsconfig.json para Proyectos Modernos
Configuración estricta para proyectos con Node.js / Express y frameworks frontend.
{
"compilerOptions": {
// 1. Lenguaje y Versión de Salida
"target": "ES2022", // Sintaxis JS moderna generada
"module": "NodeNext", // Soporte nativo para ES Modules (import/export)
"moduleResolution": "NodeNext", // Resolución de módulos estándar de Node.js
"lib": ["ES2022"], // Incluir APIs de ES2022 (añadir "DOM" si es frontend)
// 2. Estrictez Absoluta (Zero Bugs)
"strict": true, // Activa todas las reglas estrictas de tipos
"noImplicitAny": true, // No permite tipos any invisibles
"strictNullChecks": true, // null y undefined deben manejarse explícitamente
"noUnusedLocals": true, // Error ante variables declaradas y no utilizadas
"noUnusedParameters": true, // Error ante parámetros de funciones no utilizados
"noImplicitReturns": true, // Todas las ramas lógicas de una función deben retornar valor
"noFallthroughCasesInSwitch": true, // Evita olvidar 'break' en sentencias switch
// 3. Estructura de Archivos
"rootDir": "./src", // Directorio donde reside el código TypeScript
"outDir": "./dist", // Directorio donde se emitirá el JavaScript compilado
"removeComments": true, // Elimina comentarios en los archivos .js compilados
// 4. Alias de Rutas y Resolución
"baseUrl": ".",
"paths": {
"@/*": ["src/*"],
"@controllers/*": ["src/controllers/*"],
"@services/*": ["src/services/*"],
"@models/*": ["src/models/*"]
},
// 5. Interoperabilidad y Rendimiento
"esModuleInterop": true, // Permite importar módulos CommonJS como ES Modules
"skipLibCheck": true, // Salta el chequeo de tipos en node_modules (acelera builds)
"forceConsistentCasingInFileNames": true // Evita errores entre sistemas sensibles a mayúsculas (Linux vs Windows)
},
"include": ["src/**/*"],
"exclude": ["node_modules", "dist", "**/*.spec.ts"]
}
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Qué beneficio aporta tener activada la directiva strictNullChecks: true dentro del archivo tsconfig.json?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar TypeScript Profesional: Tipado Estático & Arquitectura Frontend/Backend y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.