前端开发环境搭建踩坑笔记——npm install node-sass安装失败的解决方案
创始人
2025-01-15 01:04:29
0次

文章目录

    • 问题背景
    • 问题描述
    • 解决方案
      • 1. 检查node-sass安装版本是否正确。
      • 2. 检查是否是网络问题
    • 总结

问题背景

开发新的前端项目时,总少不了搭建开发环境和执行npm install安装依赖包,但npm install的过程总是充满着玄学,很难保证一次性成功,其中尤其以node-sass这个包的安装失败问题最为常见。
像其他npm包安装失败,通常是因为网络问题,可以采用使用更好的网络环境或者切换源的方式进行安装,比如使用淘宝的源进行安装,命令如下:

npm install --registry=https://registry.npmmirror.com 

但node-sass安装失败这个问题似乎无法通过上述命令解决。本文将总结遇到此类问题时的解决方案。

问题描述

笔者的测试环境如下:

操作系统:Windows 11 Node版本:v14.16.0 Npm版本:6.14.11 

遇到的node-sass安装失败的报错如下:

gyp ERR! find VS gyp ERR! find VS msvs_version not set from command line or npm config gyp ERR! find VS VCINSTALLDIR not set, not running in VS Command Prompt gyp ERR! find VS checking VS2022 (17.5.33530.505) found at: gyp ERR! find VS "D:\Program Files\Microsoft Visual Studio\2022\Community" gyp ERR! find VS - found "Visual Studio C++ core features" gyp ERR! find VS - found VC++ toolset: v143 gyp ERR! find VS - missing any Windows SDK gyp ERR! find VS could not find a version of Visual Studio 2017 or newer to use gyp ERR! find VS looking for Visual Studio 2015 gyp ERR! find VS - not found gyp ERR! find VS not looking for VS2013 as it is only supported up to Node.js 8 gyp ERR! find VS gyp ERR! find VS ************************************************************** gyp ERR! find VS You need to install the latest version of Visual Studio gyp ERR! find VS including the "Desktop development with C++" workload. gyp ERR! find VS For more information consult the documentation at: gyp ERR! find VS https://github.com/nodejs/node-gyp#on-windows gyp ERR! find VS ************************************************************** gyp ERR! find VS gyp ERR! configure error gyp ERR! stack Error: Could not find any Visual Studio installation to use gyp ERR! stack     at VisualStudioFinder.fail (D:\temp\npm-temp\node_modules\node-gyp\lib\find-visualstudio.js:122:47) gyp ERR! stack     at D:\temp\npm-temp\node_modules\node-gyp\lib\find-visualstudio.js:75:16 gyp ERR! stack     at VisualStudioFinder.findVisualStudio2013 (D:\temp\npm-temp\node_modules\node-gyp\lib\find-visualstudio.js:363:14) gyp ERR! stack     at D:\temp\npm-temp\node_modules\node-gyp\lib\find-visualstudio.js:71:14 gyp ERR! stack     at D:\temp\npm-temp\node_modules\node-gyp\lib\find-visualstudio.js:384:16 gyp ERR! stack     at D:\temp\npm-temp\node_modules\node-gyp\lib\util.js:54:7 gyp ERR! stack     at D:\temp\npm-temp\node_modules\node-gyp\lib\util.js:33:16 gyp ERR! stack     at ChildProcess.exithandler (child_process.js:315:5) gyp ERR! stack     at ChildProcess.emit (events.js:315:20) gyp ERR! stack     at maybeClose (internal/child_process.js:1048:16) gyp ERR! System Windows_NT 10.0.22621 gyp ERR! command "C:\\Users\\zzcoder\\AppData\\Local\\nvs\\default\\node.exe" "D:\\temp\\npm-temp\\node_modules\\node-gyp\\bin\\node-gyp.js" "rebuild" "--verbose" "--libsass_ext=" "--libsass_cflags=" "--libsass_ldflags=" "--libsass_library=" gyp ERR! cwd D:\temp\npm-temp\node_modules\node-sass gyp ERR! node -v v14.16.0 gyp ERR! node-gyp -v v8.4.1 gyp ERR! not ok Build failed with error code: 1 npm WARN npm-test@1.0.0 No description npm WARN npm-test@1.0.0 No repository field.  npm ERR! code ELIFECYCLE npm ERR! errno 1 npm ERR! node-sass@8.0.0 postinstall: `node scripts/build.js` npm ERR! Exit status 1 npm ERR! npm ERR! Failed at the node-sass@8.0.0 postinstall script. npm ERR! This is probably not a problem with npm. There is likely additional logging output above.  npm ERR! A complete log of this run can be found in: npm ERR!     C:\Users\zzcoder\AppData\Roaming\npm-cache\_logs\2023-05-06T06_13_42_083Z-debug.log 

附上报错截图:

报错截图

解决方案

1. 检查node-sass安装版本是否正确。

本地安装的node版本不同,需要安装的node-sass版本也是不一样的。node-sass官方给出了不同版本的node和node-sass的对应关系,读者可访问node-sass github仓库或者node-sass npm仓库进行查看。
本地安装的node版本,可以使用如下命令进行查看:

node -v 

下图为截至node-sass@8.0.0版本时的对应关系。

node与node-sass对应关系

在项目中还没有package.json或者有package.json但是此文件没有指定node-sass的版本时,默认会安装node-sass的最新版本。由于笔者安装的node版本时14.16.0,执行npm install node-sass命令默认安装了撰写本文时的node-sass最新版本8.0.0,所以才有了前文中报错。

版本错误

根据版本对应关系,笔者应该安装node-sass的4.14+版本,因此需要将安装命令改为:

npm install node-sass@^4.14.0 --registry=https://registry.npmmirror.com 

这样就是使用淘宝源来安装node-sass的4.14+中的最新版本。

2. 检查是否是网络问题

在使用npm install安装node-sass时,会从 github.com 上下载 .node 文件。由于国内网络环境的问题,这个下载时间可能会很长,甚至导致超时失败。

npm WARN deprecated @npmcli/move-file@2.0.1: This functionality has been moved to @npmcli/fs npm WARN deprecated @npmcli/move-file@1.1.2: This functionality has been moved to @npmcli/fs  > node-sass@8.0.0 install D:\temp\npm-temp\node_modules\node-sass > node scripts/install.js  Downloading binary from https://github.com/sass/node-sass/releases/download/v8.0.0/win32-x64-83_binding.node Cannot download "https://github.com/sass/node-sass/releases/download/v8.0.0/win32-x64-83_binding.node":  HTTP error ETIMEDOUT request to https://github.com/sass/node-sass/releases/download/v8.0.0/win32-x64-83_binding.node failed, reason: connect ETIMEDOUT 20.205.243.166:443  Hint: If github.com is not accessible in your location       try setting a proxy via HTTP_PROXY, e.g.        export HTTP_PROXY=http://example.com:1234  or configure npm proxy via        npm config set proxy http://example.com:8080  > node-sass@8.0.0 postinstall D:\temp\npm-temp\node_modules\node-sass > node scripts/build.js 

附上报错截图。

github下载.node文件

这种情况下仅使用--registry参数指定npm包的下载源是不够的,还需要使用--sass_binary_site参数指定sass二进制文件的下载源,因此需要将安装命令改为:

npm install node-sass@^4.14.0 --registry=https://registry.npmmirror.com --sass_binary_site=https://www.npmmirror.com/mirrors/node-sass/ 

这样一来就是指定node-sass版本,指定npm包下载源为淘宝源,指定sass下载源为淘宝源,使用此命令基本就都能安装成功了。
node-sass安装成功

总结

遇到node-sass安装失败时,可以使用以下命令:

# 查看本地node版本 node -v  # 安装node-sass npm install node-sass@[本地node所对应的node-sass版本] --registry=https://registry.npmmirror.com --sass_binary_site=https://www.npmmirror.com/mirrors/node-sass/ 

通过下表查看版本对应关系,也可访问node-sass github仓库或者node-sass npm仓库进行查看。

node与node-sass对应关系

欢迎批评指正。

相关内容

热门资讯

信息共享辅助!百盛娱乐辅助多功... 信息共享辅助!百盛娱乐辅助多功能AI软件,百盛娱乐确实存在有辅助软件百盛娱乐能透视中分为三种模型:百...
安装程序教程开挂!天游大厅开挂... 安装程序教程开挂!天游大厅开挂多功能AI技巧,天游大厅一贯存在有开挂技巧1、每一步都需要思考,不同水...
一起来讨论辅助器!超稳新城辅助... 一起来讨论辅助器!超稳新城辅助器多功能AI脚本,超稳新城总是有辅助器脚本1、超稳新城破解器简单,超稳...
发现一款辅助!新果汁大厅辅助多... 发现一款辅助!新果汁大厅辅助多功能AI方法,新果汁大厅一直有辅助方法1、下载好新果汁大厅正确养号方法...
玩家必看科普外挂!红莲外挂多功... 玩家必看科普外挂!红莲外挂多功能AI脚本,红莲总是真的有外挂脚本运红莲辅助工具,进入游戏界面。进入红...
WPK下载透视挂,wpk透视是... WPK下载透视挂,wpk透视是真的假的,微扑克本来真的有透视挂攻略1)wpk透视是真的假的免费钻石:...
WPK链接透视,智星德州辅助译... WPK链接透视,智星德州辅助译码插件靠谱吗,智星菠萝德州本来真的有透视工具1、完成智星德州辅助译码插...
WPK私人局开挂,德扑之星透视... WPK私人局开挂,德扑之星透视辅助软件是真的吗,wpk竟然是有开挂工具1、下载好德扑之星透视辅助软件...
WPK透视辅助器,pokerw... WPK透视辅助器,pokerworld破解版下载,德州扑克原来真的有辅助器教程该软件可以轻松地帮助玩...
WPK靠谱开挂,哈糖大菠萝免费... WPK靠谱开挂,哈糖大菠萝免费辅助器,WePoKer真是存在有开挂软件1、金币登录送、破产送、升级送...