Mac Catalina下MDC 101教程npm install报错原因咨询

让我帮你拆解下这个问题的核心原因，以及为什么你最后重装fibers能解决问题——本质上都是Node.js版本兼容性在搞鬼：

1. 为什么fsevents@1.2.7和fibers@4.0.1会编译失败？ #

你使用的Node.js v14.15.3是2020年底发布的版本，而教程依赖的fsevents@1.2.7和fibers@4.0.1都是2018年左右的旧包，它们的源码是基于当时的Node.js/V8 API编写的，和Node.js v14的API变化完全不兼容：

• fsevents@1.2.7：这个版本的预编译二进制包只支持到Node.js v10，所以npm会自动尝试从源码编译。但它依赖的Nan（Node.js原生模块的抽象层）版本太老，不兼容Node.js v14里的V8 API变更：比如Nan::Persistent::IsNearDeath()方法在新Nan版本中被移除，v8::Handle模板在V8 7.x（Node.js v12+采用的V8版本）中被废弃替换为v8::Local，还有Set函数的参数签名也发生了变化，这些都会直接导致编译失败。
• fibers@4.0.1：fibers对Node.js版本的兼容性要求非常严格，这个版本的fibers完全没有适配Node.js v14的V8 API，编译时的Set函数参数不匹配就是典型的API不兼容问题。

2. 为什么更新fsevents后仍提示fibers二进制缺失？ #

你只更新了fsevents到兼容版本，但fibers还是停留在4.0.1这个不支持Node.js v14的旧版本——它要么编译失败根本没生成可用的二进制文件，要么就算勉强安装成功，也无法在Node.js v14环境下正常加载，所以启动服务器时会触发“fibers二进制文件缺失”的报错。

3. 为什么重装fibers能解决问题？ #

当你卸载并重装fibers时，如果你的项目package.json里没有锁死fibers的版本（比如用了^4.0.1这种宽松版本约束，或者根本没指定版本），npm会自动拉取适配你当前Node.js v14的fibers最新兼容版本（比如fibers@5.x系列，这些版本已经更新了V8 API调用，支持Node.js v12+），自然就能正常编译运行了。

更彻底的解决方案 #

方案1：锁定Node.js版本（推荐，适配旧教程） #

MDC 101 Web教程是比较早期的内容，建议使用教程发布时推荐的Node.js版本（比如v10或v12），用nvm（Node版本管理器）来切换：

# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 安装Node.js v12
nvm install 12
# 切换到v12环境
nvm use 12
# 清理旧依赖后重新安装
rm -rf node_modules package-lock.json
npm install

这样旧版本的fsevents和fibers就能直接使用预编译二进制包，不会出现编译错误。

方案2：手动更新依赖到兼容版本 #

如果不想切换Node.js版本，可以直接更新两个依赖包到支持Node.js v14的版本：

# 更新fsevents到最新兼容版本
npm install fsevents@latest --save-dev
# 更新fibers到支持Node.js v14的版本
npm install fibers@^5.0.0 --save

更新完成后重新启动服务器即可。

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