一、问题描述:
当我们拿到一个项目,准备 npm install
或是 yarn install
后大展身手时,经常就会遇到 node-sass 报错问题,导致依赖安装失败!查阅网络,解决方式五花八门,所以在此我总结一下安装 node-sass 时我们可能会遇到的一些常见问题。
二、常见问题及解决方式
1、官方镜像环境在国内下载速度慢,有概率安装不成功
解决方法:可以使用 淘宝镜像 来下载相关依赖
npm config set registry https://registry.npmmirror.com
设置完成后,可以使用以下命令来检查是否设置成功:
npm config get registry
如果输出:https://registry.npmmirror.com 则已经改为淘宝镜像。
注意:由于原淘宝镜像地址 https://registry.npm.taobao.org 的HTTPS域名到期,已替换为 https://registry.npmmirror.com
2、node版本和node-sass版本不匹配
查看node-sass官网,可以看到有张 node 和 node-sass 的版本匹配表,我们可以按照这张表来选择版本使用:
解决方法:
①、可以修改 node 版本来匹配项目中已使用的 node-sass 版本。为了避免重复的安装卸载 node ,可以使用 nvm,它是一个 nodejs 的版本管理工具,可以非常轻松的去切换 nodejs 版本。
②、使用 npm install node-sass@版本号
指定版本号的方式去安装符合 node 版本的 node-sass。
注意 :这里可能会有一点小问题,我的 nodejs 版本为 @16.20.2 但是还是安装不上 node-sass@6.0.1 ,若出现这种情况,我们可以继续降低 node 版本或 升高 node-sass版本,我这里将 nodejs 版本将为 @14.21.3 就可以正常安装了。不知是不是小版本的问题导致的,欢迎大佬们指正。
3、会报 python错误:python版本错误、python找不到、python配置错误。。。
解决方法:若控制台报 python 相关错误,其实有一部分原因还是因为 nodejs 版本不匹配导致的,我们只需参照 问题2 修改版本即可。