解决Nodemon监控YAML文件变更不触发重启的问题

Nodemon作为Node.js开发中常用的文件监控工具，能够自动重启应用以响应代码变更。但在实际使用中，开发者可能会遇到一个特定场景下的监控失效问题：当通过-w参数显式指定监控YAML文件时，文件变更却不会触发应用重启。

问题现象

在项目中配置了类似nodemon -w src/openapi.yaml -w src src/server.ts的命令后，开发者期望当src/openapi.yaml文件发生变更时能够触发应用重启。然而实际运行中，只有TypeScript文件变更会触发重启，YAML文件的修改被完全忽略。

问题根源

经过深入分析，发现这是Nodemon内部路径匹配逻辑的一个缺陷。当监控的文件位于子目录中时，Nodemon的默认文件扩展名匹配机制会覆盖显式指定的文件监控规则。具体表现为：

1. Nodemon默认只监控.js,.mjs,.coffee,.litcoffee,.json等扩展名
2. 即使通过-w显式指定了YAML文件路径，由于扩展名不在默认列表中，变更仍被忽略
3. 当监控的文件与命令在同一目录时，问题不会出现

解决方案

针对这个问题，目前有两种可行的解决方法：

1. 临时解决方案：在命令中添加--ext yaml,ts参数，显式声明需要监控的文件扩展名。但这种方法可能会意外监控到其他不需要的YAML文件。

2. 永久解决方案：升级到Nodemon 3.1.6及以上版本，该版本已修复此路径匹配逻辑问题。新版本正确处理了子目录中显式指定文件的监控需求。

技术原理

这个问题的修复涉及Nodemon核心监控机制的改进：

1. 文件路径解析逻辑优化，确保相对路径和绝对路径都能正确匹配
2. 显式指定的文件监控规则优先级提高，不再受默认扩展名列表限制
3. 子目录监控场景下的路径规范化处理

最佳实践

为避免类似问题，建议开发者：

1. 保持Nodemon版本更新，使用最新稳定版
2. 对于非标准扩展名的配置文件，同时使用-w和--ext参数
3. 在复杂项目中，考虑使用nodemon.json配置文件替代命令行参数
4. 定期检查监控日志，确认所有需要监控的文件变更都被正确捕获

这个问题虽然看似简单，但反映了工具设计中默认配置与显式配置优先级处理的重要性。Nodemon团队的快速响应和修复也展示了开源社区解决问题的效率。