Docker+Windows环境下Node Express+TypeScript热重载失效求助

1. 正确配置nodemon.json启用legacy-watch #

在你的nodemon.json中添加legacyWatch配置项，开启旧版监听模式适配Windows+Docker的文件系统通知逻辑：

{
  "watch": ["src"],
  "ext": "ts,json",
  "exec": "ts-node src/index.ts",
  "legacyWatch": true
}

注：配置文件中使用驼峰命名的legacyWatch，对应命令行参数--legacy-watch。

2. 确保Docker容器挂载本地源码卷 #

热重载的核心是本地代码修改能实时同步到容器内，运行容器时必须挂载本地源码目录到容器对应路径：

• Linux/macOS/WSL2终端：

  docker run -v $(pwd)/src:/app/src -p 3000:3000 your-image-tag
  

• Windows PowerShell：

  docker run -v ${PWD}/src:/app/src -p 3000:3000 your-image-tag
  

• Windows CMD：

  docker run -v %cd%/src:/app/src -p 3000:3000 your-image-tag
  

如果要同步整个项目目录，可挂载根目录并配合.dockerignore排除不必要文件：

docker run -v $(pwd):/app -p 3000:3000 your-image-tag

.dockerignore示例：

node_modules
dist
.dockerignore
Dockerfile

3. 检查package.json启动脚本与Dockerfile命令 #

确保package.json的开发脚本指向nodemon：

{
  "scripts": {
    "dev": "nodemon",
    "start": "ts-node src/index.ts"
  },
  "devDependencies": {
    "nodemon": "^3.0.0",
    "ts-node": "^10.9.0",
    "typescript": "^5.0.0"
  }
}

Dockerfile中要执行开发脚本，而非直接启动编译后的文件：

FROM node:18-alpine

WORKDIR /app

# 先安装依赖，利用Docker缓存
COPY package*.json ./
RUN npm install

# 复制项目文件（运行时会被挂载的卷覆盖）
COPY . .

# 启动开发服务
CMD ["npm", "run", "dev"]

4. 无需全局安装ts-node #

不需要全局安装ts-node，通过本地开发依赖安装即可，容器内执行npm install会自动安装所有依赖，避免环境不一致问题。

5. Windows环境额外优化 #

• 如果使用WSL2，建议将项目放在WSL本地文件系统（如~/projects），而非Windows挂载目录（/mnt/c），后者的文件系统通知存在延迟，会导致nodemon无法及时检测变化。
• 若使用原生Docker Desktop，确保在设置中开启了对应磁盘的文件共享权限。
• 可在nodemon.json中添加delay参数，避免文件频繁修改导致的重复重启：

  {
    // ...其他配置
    "delay": 1000
  }
  

内容的提问来源于stack exchange，提问作者CarlP