Tema 2 · Tooling & tsconfig

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 como any cuando TypeScript no pueda inferir su tipo.
  • strictNullChecks: Obliga a contemplar explícitamente valores null y undefined, 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 bloque catch (err) sea de tipo unknown en lugar de any, forzando a verificar si es una instancia de Error antes de acceder a err.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.

tsconfig.json
Solo lectura
{
  "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
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.