Lección 72 — Instalación y Configuración

🧠 Concepto

Para empezar a usar TypeScript necesitas tener Node.js instalado. Luego instalas el compilador TypeScript globalmente o lo ejecutas con npx.

Instalación global

npm install -g typescript

Esto instala el comando tsc en tu sistema. Puedes verificar la versión con:

tsc --version

Sin instalación (npx)

Si prefieres no instalar globalmente:

npx tsc --version

Compilar un archivo

tsc archivo.ts

Esto genera archivo.js en el mismo directorio. Si quieres especificar el nombre de salida:

tsc archivo.ts --outFile salida.js

💻 Ejemplo

Crear y compilar el primer archivo

hola.ts

let mensaje: string = '¡Hola TypeScript!';
console.log(mensaje);

tsc hola.ts
# → genera hola.js
node hola.js
# → ¡Hola TypeScript!

⚙️ tsconfig.json

El archivo tsconfig.json centraliza la configuración del proyecto. Se genera con:

tsc --init

Opciones clave que debes conocer:

Opción	Descripción	Recomendado
target	Versión JS de salida	"ES2020" o superior
module	Sistema de módulos	"ESNext" o "commonjs"
outDir	Carpeta de salida JS	"./dist"
rootDir	Carpeta de origen TS	"./src"
strict	Activa todas las comprobaciones estrictas	true
sourceMap	Genera mapas para debugging	true
include	Patrones de archivos a incluir	["src/**/*"]
exclude	Patrones a excluir	["node_modules"]

Ejemplo de tsconfig.json

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ESNext",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true,
    "sourceMap": true,
    "skipLibCheck": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}

📝 Ejercicio

Crea una carpeta mi-proyecto-ts, dentro crea src/index.ts con el código:

console.log('Configurando TypeScript');

Genera el tsconfig.json con tsc --init, configúralo con rootDir: "./src" y outDir: "./dist", compila y ejecuta el resultado.

⚠️ Nota

El modo strict activa varias opciones a la vez: strictNullChecks, noImplicitAny, strictFunctionTypes, etc. Es mejor activarlo desde el principio para escribir código más seguro.

🎯 Tip

Usa tsc --watch para que el compilador se ejecute automáticamente cada vez que guardes un archivo. Ideal para desarrollo.