解决 使用 npm 安装 插件,报错 : Maximun call stack size exceeded

• • 1. 解决 使用 npm 安装 插件，报错 ： Maximun call stack size exceeded
• • 1.1. 问题分析与解决方案
• • 1.1.1. 清除 npm 缓存（最常用且有效的第一步）
• • 1.1.2. 升级/降级 npm 版本
• • 1.1.3. 删除 node_modules 和 package-lock.json 重新安装
• • 1.1.4. 检查 Node.js 版本兼容性
• • 1.1.5. 临时禁用 npm 脚本（若插件有预安装/后安装脚本）
• • 1.2. 总结

1. 解决 使用 npm 安装 插件，报错 ： Maximun call stack size exceeded

你遇到的这个 Maximum call stack size exceeded 错误，本质上是调用栈溢出，在使用 npm 安装插件时出现这个问题，通常不是插件本身的问题，而是 npm 自身的运行环境或依赖关系出现了循环引用/递归调用导致的。

1.1. 问题分析与解决方案

我会按从简单到复杂的顺序，给你提供一套可操作的解决步骤，你可以逐一尝试：

1.1.1. 清除 npm 缓存（最常用且有效的第一步）

npm 缓存损坏或异常是导致这类奇怪错误的常见原因，先执行缓存清理：

//# 清除旧版 npm 缓存npm cache clean --force//# 如果是 npm 7+ 版本，也可以用这个命令npm cache verify

1.1.2. 升级/降级 npm 版本

npm 版本不兼容也可能引发这个问题，你可以尝试升级到最新版，或降级到一个稳定版本：

//# 升级到最新版 npmnpm install -g npm@latest//# 若最新版仍有问题，可降级到稳定版（比如 9.x）npm install -g npm@9.8.1

1.1.3. 删除 node_modules 和 package-lock.json 重新安装

项目中已安装的依赖可能存在循环依赖，导致安装新插件时触发栈溢出：

//# 1. 删除 node_modules 文件夹（Windows 系统用 rmdir /s /q node_modules）rm -rf node_modules//# 2. 删除锁文件rm -rf package-lock.json yarn.lock//# 3. 重新安装所有依赖（先确保基础依赖正常）npm install//# 4. 再尝试安装目标插件npm install 你的插件名称 --save

1.1.4. 检查 Node.js 版本兼容性

过高/过低的 Node.js 版本可能和 npm 或插件不兼容：

//# 查看当前 Node.js 版本node -v//# 推荐使用 LTS 版本（如 16.x、18.x、20.x），可通过 nvm 切换版本（以 nvm 为例）//# 安装 nvm（Linux/Mac）curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash//# 安装 LTS 版本 Node.jsnvm install --lts//# 使用 LTS 版本nvm use --lts

1.1.5. 临时禁用 npm 脚本（若插件有预安装/后安装脚本）

部分插件的 preinstall/postinstall 脚本可能触发递归调用，可临时禁用：

npm install 你的插件名称 --save --ignore-scripts

1.2. 总结

1. 1. Maximum call stack size exceeded 核心原因是调用栈溢出，npm 场景下多由缓存、版本兼容、循环依赖导致；
2. 2. 优先尝试「清除缓存 → 删除锁文件和 node_modules → 重新安装」的基础流程；
3. 3. 若仍报错，检查 Node.js/npm 版本（推荐 LTS 版），或禁用插件的安装脚本。

如果尝试以上步骤后仍报错，可以补充说明你要安装的插件名称、Node.js/npm 版本，我会帮你定位更具体的原因。

更多详细内容，请微信搜索“前端爱好者“， 戳我 查看 。