tsx vs tsc vs ts-node

Elige la cadena de herramientas de TypeScript adecuada para cada entorno: tsx para un desarrollo y pruebas rápidos, tsc para dist/ de producción, y evita la adopción de ts-node a menos que las restricciones de proyectos existentes lo requieran.

Receta

{
  "scripts": {
    "dev": "node --watch --import tsx src/main.ts",
    "build": "tsc -p tsconfig.json",
    "start": "node dist/main.js",
    "test": "node --import tsx --test src/**/*.test.ts"
  },
  "devDependencies": {
    "typescript": "^5.6.0",
    "tsx": "^4.0.0",
    "@types/node": "^24.0.0"
  }
}

Cuándo usar esto:

• Al iniciar un nuevo servicio Express 5 o Fastify 5
• Al elegir comandos de CI que reflejen la producción
• Al reemplazar pilas de ts-node-dev o nodemon + ts-node
• Al depurar desajustes de "funciona con tsx, falla con node dist"

Ejemplo de trabajo

// src/main.ts
import { createServer } from 'node:http';
 
const port = Number(process.env.PORT ?? 3000);
 
createServer((_req, res) => {
  res.end('ok');
}).listen(port, () => console.log(`Escuchando en el puerto ${port}`));

# Desarrollo - sin paso de compilación separado
npm run dev
 
# Pipeline de producción
npm run build
npm run start

// tsconfig.json - emitir para producción
{
  "compilerOptions": {
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "outDir": "dist",
    "rootDir": "src",
    "declaration": true,
    "sourceMap": true,
    "strict": true
  }
}

Lo que esto demuestra:

• tsx engancha el cargador de Node: transforma TS sobre la marcha a través de esbuild
• tsc escribe dist/main.js preservando los especificadores de importación de ESM con extensiones .js
• La producción ejecuta node simple, sin cargador de devDependency en el contenedor
• --watch + tsx reemplaza a nodemon para muchos servicios

Análisis profundo

Cómo funciona

• tsx - transformación esbuild, inicio rápido, soporta ESM e import.meta, ideal para desarrollo/pruebas.
• tsc - verificación de tipos completa + emisión; más lento pero autoritativo para declaraciones y dist/.
• ts-node - integración de compilador sobre la marcha más antigua; el soporte de ESM es más delicado que tsx.
• tsc --noEmit - trabajo de CI solo de verificación de tipos sin emisión; se combina con el trabajo de build.

Comparación de pipelines

Notas de TypeScript

{
  "scripts": {
    "typecheck": "tsc --noEmit",
    "dev": "node --watch --import tsx src/main.ts"
  }
}

Ejecuta typecheck en CI incluso cuando el desarrollo usa tsx; tsx por sí solo omite los errores de tipo.

Errores comunes

• Desplegar tsx en producción - añade superficie de devDependency y sobrecarga de transformación. Solución: node dist/main.js en Docker CMD.
• tsx pasa errores de tipo - solo transpilación. Solución: tsc --noEmit en la puerta de CI.
• Alias de rutas sin soporte de emisión - tsc no reescribe paths. Solución: importaciones relativas de NodeNext o paso posterior tsc-alias.
• Salida de módulo diferente (CJS vs ESM) - tsx ejecuta el código fuente; tsc emite según module. Solución: alinear "type" de package.json con la emisión.
• Mantener ts-node para ESM en 2026 - configuración más difícil que tsx. Solución: migrar scripts de desarrollo a node --import tsx.

Alternativas

Preguntas frecuentes

Relacionado

• Conceptos básicos de TypeScript en Node - valores predeterminados de tsconfig
• Tipado gradual en proyectos existentes - migración de bases de código JS
• Verificación de tipos en CI - compuertas de fusión
• Ejecución de scripts y Shebang - scripts de npm

Versiones de la pila: Esta página fue escrita para Node.js 24.18.0 (LTS activa), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 y NestJS 11.