本地安装shepherd.js出现错误，如何解决？

针对你遇到的两类错误，按以下步骤排查解决： #

1. 彻底清理npm缓存与残留文件 #

• 清理npm缓存：

  npm cache clean --force
  

• 删除项目根目录下的package-lock.json文件
• 再次删除node_modules文件夹：

  rm -rf node_modules
  

2. 解决deepmerge目录冲突问题 #

之前手动重命名无效，大概率是node进程占用了该目录，先终止所有node相关进程：

pkill -f node

然后强制删除deepmerge目录：

sudo rm -rf node_modules/deepmerge

3. 重新执行安装流程 #

• 先安装基础依赖：

  npm install
  

• 再安装shepherd.js：

  npm install shepherd.js --save
  

4. 备选方案：强制跳过冲突或兼容旧依赖 #

如果上述步骤无效，尝试：

• 强制安装跳过冲突：

  npm install shepherd.js --save --force
  

• 兼容旧版peer依赖（若为版本兼容性问题）：

  npm install shepherd.js --save --legacy-peer-deps
  

5. 检查npm版本兼容性 #

当前使用的npm 10.5.1可能与shepherd.js依赖存在兼容问题，可尝试降级到稳定版本，比如10.4.0：

npm install -g npm@10.4.0

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