Node.js中使用nodemon实现TypeScript项目热更新的三种方案

作者：岩茶

时间：2026-10-23

本文总结了在Node.js开发中使用nodemon实现TypeScript项目热更新的三种方法。第一种通过tsc编译后运行dist目录，存在监听滞后问题；第二种结合ts-node直接执行源码，支持命令行或配置文件；第三种直接运行ts文件并配置ext属性。文章提供了具体的命令示例和nodemon.json配置细节，帮助开发者提升开发效率。

文章目录

引言

在Node.js开发环境中，nodemon常被用于自动监听文件变化并重启服务器，从而提升JavaScript项目的开发体验。随着TypeScript的普及，许多开发者希望在使用TS编写代码的同时，也能享受这种自动重启的便利。本文将总结几种实现TypeScript项目热更新的有效方法。

方案一：nodemon配合tsc编译

该方法的逻辑较为直观：首先利用tsc编译器将TypeScript源码编译生成JavaScript文件，并输出到指定的dist目录中；随后，配置nodemon监听该dist目录下的文件。关于TypeScript编译输出的目录路径及其他相关配置，可以在tsconfig.json文件中进行定义。


tsc && nodemon --watch dist/index.js

然而，这种方式存在明显的局限性。由于nodemon仅监听编译后的dist目录，当开发者修改TypeScript源码时，若未触发编译步骤，热更新可能无法及时响应。此外，引入dist目录作为中间层增加了项目结构的复杂性，部分开发者对此并不满意。

方案二：nodemon配合ts-node

可以通过命令行参数直接指定监听扩展名和执行器。


nodemon -e ts,tsx --exec ts-node ./index.ts"

上述命令的核心含义是：设置nodemon监听ts和tsx两种文件类型的变化，并调用ts-node工具直接执行index.ts入口文件，从而跳过手动编译步骤。

除了命令行传参，更推荐将配置写入nodemon.json文件中，以便持久化管理。


{
 "verbose": false,
 "debug": false,
 "exec": "ts-node ./index.ts",
 "ignore": [
  "mochawesome-report",
  "node_modules",
  "./test",
  "**/*.d.ts",
  "*.test.ts",
  "*.spec.ts",
  "fixtures/*",
  "test/**/*",
  "docs/*"
 ],
 "events": {
  "restart": ""
 },
 "watch": ["./app", "./configs", "./app.ts"],
 "ext": "ts tsx",
 "inspect": true
}

需要注意的是，如果项目中使用了tsx文件，务必在tsconfig.json中取消对jsx配置的注释，否则在编译或运行时可能会遇到类型检查错误。

方案三：直接执行ts文件

除了上述两种常见做法，还有一种更简便的尝试：直接使用nodemon执行TypeScript文件。起初控制台可能会报错，由于英文提示信息较为晦涩，难以直接定位问题。但在安装ts-node依赖后重新尝试，发现该方式可以正常运行。


nodemon ./index.ts

尽管直接执行ts文件可行，但默认配置下修改ts源码并不会触发热更新。解决方法是在nodemon.json配置文件中，将ext属性扩展包含ts扩展名，例如设置为“js json ts tsx”，即可实现源码变更时的自动重启。


{
 "restartable": "rs",
 "ignore": [".git", "node_modules/**", "client/*", "dist", ".cache", "logs"],
 "verbose": true,
 "execMap": {
  "": "node",
  "js": "node --harmony"
 },
 "events": {
  "start": "",
  "crash": "",
  "exit": "",
  "restart": ""
 },
 "ext": "js json ts tsx",
 "watch": ["./**"],
 "env": {
  "NODE_ENV": "development",
  "PORT": "3002"
 },
 "legacy-watch": false
}