nodemon监听规则中无引号src/**/*与带引号'src/**/*'的区别及报错原因
nodemon 两种watch配置写法的运行差异解析
核心本质:Shell与nodemon的通配符解析权责划分
package.json 中 scripts 字段的所有命令,在类Unix系统下会默认通过 bash/zsh 解析执行:Shell会先对命令行参数做一轮通配符预处理,再把处理后的参数结果传给后续调用的程序(这里就是nodemon)。两个配置的运行结果差异,完全来自这步预处理的逻辑不同:
- 无引号写法的实际执行过程
不带引号的src/**/*会被Shell直接做通配符展开:按照当前工作目录下的真实文件列表,把通配符替换成所有匹配到的实际文件路径,不会把完整的通配规则字符串传给nodemon。
对应你碰到的报错场景:当前src目录下存在零散的旧编译残留.js文件,展开后的路径列表里包含了这些.js文件的绝对路径。这些残留的js文件是ESModule语法导出的代码,和当前Node环境的CommonJS模块规则不兼容,会被Node的原生模块解析逻辑在加载路由模块时优先命中(Node默认对同路径的文件优先匹配.js后缀),最终抛出Unexpected token 'export'的语法错误。
额外说明:默认配置下的Shell没有开启globstar规则,**在未被引号保护时实际等价于单层的*,连多层嵌套的子目录文件都匹配不全,进一步导致监听范围完全偏离预期。 - 带单引号写法的实际执行过程
被单引号包裹的'src/**/*'会被Shell识别为纯字符串,不做任何通配符展开,原封不动作为参数传递给nodemon。这时候通配规则的解析权完全交给nodemon本身:nodemon内置基于chokidar的glob匹配能力,按照src/**/*的规则递归匹配所有src目录下的目标文件,不会混入本地残留的js文件路径,自然不会触发错误加载,项目就能正常启动。
避坑提示:你当前的src目录下存在tsc编译生成的零散.js残留文件,就算用带引号的写法暂时正常运行,后续这些残留文件也可能在Node模块解析的优先级排序中优先于.ts源文件被加载,引发难以排查的路径错误。建议及时清理src目录下的所有手动生成的.js文件,将编译输出统一指向build这类独立目录,从根源上避免源文件和编译产物的路径混淆。
内容的提问来源于stack exchange,提问作者Treo
相关产品推荐
相关产品推荐

