MacOS Sonoma环境下fsevents包异常导致npm run dev失败求助

可行解决方案 #

1. 彻底清理依赖与缓存 #

执行以下命令重置依赖环境，解决缓存损坏或版本冲突问题：

npm cache clean --force
rm -rf node_modules
rm package-lock.json
npm install

2. 锁定rollup-plugin-inject兼容版本 #

由于它是间接依赖，可在package.json中添加resolutions字段强制指定稳定版本：

"resolutions": {
  "rollup-plugin-inject": "^3.0.2"
}

添加后重新执行npm install即可生效。

3. 排除二进制文件解析 #

在项目的rollup配置文件（如rollup.config.js）中，阻止rollup-plugin-inject解析.node格式的二进制文件：

export default {
  // 其他配置项
  external: [/\.node$/],
  plugins: [
    // 其他插件
    {
      name: 'ignore-fsevents',
      resolveId(id) {
        if (id.includes('fsevents.node')) return id;
      },
      load(id) {
        if (id.includes('fsevents.node')) return 'export default {}';
      }
    }
  ]
};

4. 降级Node版本测试 #

部分依赖对Node 20 LTS兼容性不足，可切换至Node 18 LTS尝试：

# 若已安装nvm
nvm install 18
nvm use 18
rm -rf node_modules package-lock.json
npm install
npm run dev

5. 检查项目注入类配置 #

排查项目的babel.config.js或vite.config.js，看是否存在自动注入的相关配置，尝试临时禁用后重新运行项目。

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