如何彻底阻止npm安装过时的node-sass v3.13.1版本？

这种情况我之前踩过坑！明明手动指定了v4.9.4，但npm偏要拉旧版本，大概率是间接依赖冲突或者本地缓存/依赖残留搞的鬼，试试下面这一套彻底的排查和解决步骤：

1. 先找出是谁在拉旧版node-sass #

首先执行这个命令，查看整个依赖树里所有node-sass的版本和来源：

npm ls node-sass

输出里会明确显示哪个第三方依赖包间接引用了v3.13.1。找到之后，我们可以强制让所有依赖统一使用指定版本：

• 如果你的npm版本≥8.3.0，直接在package.json里添加overrides字段：

  "overrides": {
    "node-sass": "4.9.4"
  }
  

  这个配置会强制所有依赖（包括间接依赖）都使用你指定的node-sass版本。

2. 彻底清理本地依赖残留 #

有时候package-lock.json或者node_modules里的残留会导致npm“失忆”，按顺序执行以下命令：

• 先备份package-lock.json（避免丢失其他依赖的锁定版本）
• 删除本地依赖文件夹：

  # macOS/Linux
  rm -rf node_modules
  # Windows
  rmdir /s /q node_modules
  

• 删除旧的package-lock.json：

  # macOS/Linux
  rm package-lock.json
  # Windows
  del package-lock.json
  

• 强制清理npm缓存：

  npm cache clean --force
  

• 最后重新安装依赖：

  npm install
  

3. 检查npm配置和本地.npmrc文件 #

有些隐藏配置可能会偷偷指定node-sass版本：

• 查看当前npm全局配置：

  npm config list
  

  如果看到类似node-sass-version=3.13.1的配置项，用下面的命令删除：

  npm config delete node-sass-version
  

• 检查项目根目录和用户主目录下的.npmrc文件，看看有没有硬编码node-sass版本或者源的配置，有就删掉相关行。

4. 确认Node.js版本兼容性 #

node-sass和Node.js版本绑定很严格，v4.9.4对应的Node.js版本是8.x - 10.x。如果你的新电脑装了更高版本的Node.js，npm可能会试图自动降级node-sass来兼容。可以用nvm切换到兼容的Node版本再试：

# 安装nvm（如果没装的话）
nvm install 10
nvm use 10

然后再执行npm install node-sass@4.9.4。

如果以上步骤都试过还是不行，试试直接手动下载对应版本的node-sass二进制包放到缓存目录，不过一般前面的方法就能解决问题了。

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