已替换node-sass为sass仍触发安装报错，如何排查依赖源？

• 清理残留文件与缓存

  • 删除项目根目录下的node_modules文件夹：

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

  • 清理npm缓存：

    npm cache clean --force
    

  • 删除package-lock.json或yarn.lock锁文件，避免旧依赖信息残留

• 查看依赖树定位来源

  • 使用npm命令列出所有包含node-sass的依赖路径：

    npm ls node-sass
    

    输出结果会显示直接/间接依赖node-sass的包，以及完整的依赖层级
  • 若使用yarn，可执行更直观的命令：

    yarn why node-sass
    

    该命令会明确告知哪个依赖包引入了node-sass，以及引入的版本

• 检查所有package.json文件

  • 搜索项目内所有package.json，确保没有遗漏：

    # Mac/Linux
    find . -name "package.json" -type f
    # Windows（PowerShell）
    Get-ChildItem -Path . -Name "package.json" -Recurse
    

    逐一检查这些文件的dependencies和devDependencies，确认是否还有未替换的node-sass

• 检查配置文件与脚本

  • 查看各package.json的scripts字段，确认postinstall等自定义脚本是否直接调用了node-sass
  • 检查webpack、gulp等构建配置文件，比如sass-loader是否指定了implementation: require('node-sass')，这种配置也会触发node-sass的安装

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