Node.js 执行 npm install --save 时出现 fsevents 依赖警告如何修复
fsevents 安装警告处理说明
你执行npm install --save后输出的内容如下:
npm WARN optional SKIPPING OPTIONAL DEPENDENCY: fsevents@2.3.2 (node_modules\fsevents):
npm WARN notsup SKIPPING OPTIONAL DEPENDENCY: Unsupported platform for fsevents@2.3.2: wanted {"os":"darwin","arch":"any"} (current: {"os":"win32","arch":"x64"})
这条提示不属于功能故障类报错,是npm的正常平台适配反馈,完全不影响项目运行。
警告产生原因
- fsevents是仅适配macOS(darwin)系统的原生文件监听模块,作为可选依赖被webpack、nodemon等需要监听文件变动的开发工具引入,作用是优化macOS端的文件监听性能
- 你当前使用的是Windows x64环境,npm检测到该模块的适配平台与当前环境不匹配,就主动跳过了这个Windows端完全用不上的依赖安装流程,因此弹出对应提示
对应处理方案
- 如果不介意控制台的警告输出,不需要做任何额外修复操作,依赖安装、项目启动、构建打包的全流程都不会受影响
- 如果想彻底消除这类跨平台可选依赖的警告提示,可选择以下任意一种方案:
- 在项目根目录新建或编辑
.npmrc配置文件,添加一行配置optional=false后重新执行npm install,npm就不会再扫描、安装可选依赖 - 执行安装命令时追加参数直接跳过可选依赖:
npm install --save --no-optional
- 在项目根目录新建或编辑
注意事项
不要强行在Windows环境下安装fsevents模块,该模块依赖macOS专属的系统接口,强行安装会触发原生模块编译报错,反而引入真实问题。
内容的提问来源于stack exchange,提问作者Wandi play
相关产品推荐
相关产品推荐

