git clone源码执行npm i报EBADENGINE版本不兼容如何解决

• 你对npm语义化版本的^匹配规则存在认知偏差：^17仅会匹配17.x.x大版本下的所有小版本/补丁版本，不会跨大版本匹配18.x.x。报错里提到的eslint-plugin-jsdoc@37.9.7明确声明只支持Node 12/14/16/17四个大版本，你本地的Node v18.3.0不在兼容范围内，因此触发EBADENGINE引擎不兼容报错。
• 直接执行npm install lightweight-charts安装发布包能正常运行，是因为npm上的发布包是提前构建好的产物，安装时只会拉取生产依赖，不会安装eslint、单测工具这类开发依赖，自然不会触发开发依赖的引擎校验；拉源码执行npm i时会同时安装生产依赖+全量开发依赖，才会触发这个校验拦截。

按推荐优先级从高到低排列：

• 方案1（无兼容风险，首选）：通过nvm、n等Node版本管理工具，将本地当前目录的Node版本切换到16.x或17.x的稳定版，再重新执行npm i安装依赖、执行构建，完全匹配项目的版本要求，不会出现额外的兼容问题。
• 方案2（临时快速解决，无需切换版本）：安装依赖时追加参数跳过npm的引擎强制校验，命令如下：

npm i --ignore-engines

注意：这种方式只是跳过了版本校验步骤，没有真正解决版本兼容问题，如果后续执行lint、构建命令碰到和eslint插件相关的运行时报错，还是要切回项目要求的Node版本处理。

• 方案3（改造成本较高）：手动将项目内eslint-plugin-jsdoc依赖升级到支持Node 18的版本，再重新安装依赖，这种方式可能需要同步调整项目的eslint配置适配新版本插件规则，不推荐新手使用。

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