执行yarn start启动React项目失败，求助解决_FSEventStreamCreate报错问题

API 探路者

2026-5-9

解决MacOS Catalina下React项目yarn start的_FSEventStreamCreate报错问题

你遇到的是fsevents模块的兼容性问题——这个模块是webpack-dev-server用来监听文件变化的MacOS专属工具，报错是因为它的编译版本和你的系统/Node环境不匹配。试试下面的步骤来修复：

第一步：清理现有依赖和缓存
先删掉项目里的依赖文件夹和锁文件，避免残留的错误依赖影响：
```
rm -rf node_modules
rm package-lock.json yarn.lock
```
接着清理npm和yarn的缓存，确保不会从缓存里拉取旧的有问题的包：
```
npm cache clean --force
yarn cache clean
```
第二步：重新安装依赖
重新安装所有依赖，让包管理器拉取适配当前环境的版本：
```
yarn install
```
安装完成后再尝试启动项目：
```
yarn start
```
第三步：强制指定兼容的fsevents版本（如果第二步无效）
如果还是报错，说明webpack-dev-server依赖的fsevents版本和你的系统不兼容，可以在package.json里添加resolutions字段强制使用兼容版本：
在你的package.json中加入以下内容（放在和dependencies同级的位置）：
```
"resolutions": {
  "fsevents": "^2.1.3"
}
```
然后再次执行yarn install，之后启动项目应该就能正常运行了。