Windows环境下Node.js --watch模式频繁崩溃问题求助

问题背景 #

在Windows 10 64位系统的VS Code终端中，使用Node.js的--watch选项时，程序每日多次崩溃，报错信息如下：

node:internal/validators:162
throw new ERR_INVALID_ARG_TYPE(name, 'string', value);
^

TypeError [ERR_INVALID_ARG_TYPE]: The "paths[1]" argument must be of
type string. Received null
at validateString (node:internal/validators:162:11)
at resolve (node:path:171:9)
at FSWatcher. (node:internal/watch_mode/files_watcher:101:30)
at FSWatcher.emit (node:events:515:28)
at FSWatcher._handle.onchange (node:internal/fs/watchers:215:12) {   code: 'ERR_INVALID_ARG_TYPE' }

更换多个Node.js版本后问题仍存在。

可行解决方案 #

• 排除异常路径监听
  Windows下临时文件、带特殊字符的路径或系统缓存目录可能导致FSWatcher路径解析失败。启动Node时用--ignore参数直接排除这些路径：

  node --watch --ignore node_modules --ignore "*.tmp" --ignore "%temp%" your-script.js
  

  也可以在项目根目录的.gitignore文件中添加忽略规则，Node.js的watch模式会自动读取该文件的配置。

• 规避VS Code终端监听冲突
  VS Code自身的文件监听可能与Node.js的FSWatcher冲突：

  1. 打开VS Code设置（Ctrl+,），搜索files.watcherExclude，添加项目内动态生成文件目录的排除规则；
  2. 切换到系统原生终端（CMD/PowerShell）运行watch命令，避开VS Code终端环境。

• 明确指定监听范围
  不要让Node.js默认监听整个项目，手动指定需要监听的文件或目录，减少触发异常路径的概率：

  node --watch ./src ./config your-script.js
  

• 清理系统缓存
  Windows文件系统缓存异常可能引发路径解析错误：

  1. 关闭所有相关终端和VS Code窗口；
  2. 打开CMD执行ipconfig /flushdns，同时通过Win+R输入%temp%删除临时文件；
  3. 重启电脑后重新测试。

• 替换为第三方watch工具
  若原生--watch问题无法解决，改用兼容性更好的第三方工具nodemon：

  1. 全局安装：npm install -g nodemon
  2. 运行命令：nodemon your-script.js

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