npm install安装node_modules报ERESOLVE错误 依赖冲突与编译异常咨询

npm install 抛出 ERESOLVE 错误的原因 #

• 本质是存在明确的依赖版本不匹配：项目根目录声明安装的typescript@2.7.2，不满足@angular/compiler-cli@5.2.10的peer依赖要求（该包要求typescript版本区间为>=2.4.2 <2.7），两个版本范围存在硬性冲突。
• 你本地使用的npm版本为7.6.1，从npm v7版本开始，官方默认开启严格peer依赖校验机制，只要检测到依赖树存在版本不匹配，就会直接中断安装流程抛出ERESOLVE错误，这是新版本npm的默认行为变更导致的，不是项目代码本身有问题。

同事本地执行npm install无报错的原因 #

• 同事本地使用的npm版本大概率为v6.x及更早版本：旧版npm默认不强制校验peer依赖的匹配关系，会直接按照项目声明的版本安装依赖，自动跳过peer依赖的区间校验，不会触发同类报错。
• 另外两种可能的情况：一是同事本地提前配置了关闭npm严格peer校验的参数，二是同事本地项目目录已存在完整的旧依赖树，没有触发全量依赖解析流程，不会重新校验依赖版本冲突。

直接拷贝现成node_modules后无法启动的原因 #

• *跨环境直接拷贝node_modules*本身存在无法规避的兼容性问题：像node-sass这类需要根据本地Node版本、操作系统环境编译原生二进制文件的依赖，无法通过简单拷贝正常工作，哪怕执行了npm rebuild node-sass，也可能因为依赖树不完整、版本残留冲突出现运行时异常。
• 本次启动抛出的ERROR in Cannot read property 'length' of undefined是老版本webpack（你当前使用的是webpack 3.11.0）的典型不兼容问题：这类老旧版本对模块导出格式、依赖完整性的校验容错度极低，一旦出现模块版本错配、依赖文件缺失，就会直接读取未定义的对象属性触发崩溃，不会给出明确的错误指向。

• 优先清理本地项目目录下残留的node_modules文件夹、package-lock.json文件，避免旧文件造成的版本干扰。
• 执行npm install --legacy-peer-deps安装依赖，这个参数会让npm回退到v6版本的依赖解析逻辑，跳过严格的peer依赖校验，无需修改项目原有依赖版本即可正常完成安装。
• 依赖安装完成后再执行项目的启动命令，如果仍出现同类编译错误，逐一核对typescript、@angular/compiler-cli、webpack、node-sass的安装版本，确保和项目package.json中声明的版本完全一致即可。

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