最近接手一个Taro开发的项目，一上来就要被 node-sass 一直安装报错给劝退了。查看项目 package.json 中没有引入该库，使用 npm list node-sass 查看发现是 tarojs 相关包依赖。
经过本人的多次尝试，总结安装失败的主要原因有版本兼容性、网络环境和编译等因素。好了，废话不讲，开干。
1. 版本兼容性问题
首先检查版本问题，大概能解决六七成问题。
问题原因：node-sass需要与特定版本的Node.js匹配才能正常工作。
解决方法：
- 首先，检查你的Node.js版本。通过运行
node -v命令查看当前Node.js版本。 - 根据 node-sass的官方文档，找到对应Node.js版本支持的node-sass版本。
- 使用npm的指定版本安装命令进行安装，例如：
npm install node-sass@4.14.1（这里以4.14.1为例，实际应根据你的Node.js版本选择）。
建议使用 nvm 来管理 Node.js 的版本。如下是本文所用版本：
2. 网络问题
问题原因：node-sass依赖于C++编译器和一些二进制文件，这些文件通常需要从国外服务器下载，国内用户可能因网络原因导致下载失败。
解决方法：
- 使用淘宝npm镜像源。首先配置npm源为淘宝镜像：
npm config set registry https://registry.npmmirror.com，然后尝试重新安装：npm install node-sass。
若上述方式还是失败，尝试下面的离线安装方法：
- 首先先查看自己的系统架构信息：
node -p "[process.platform, process.arch, process.versions.modules].join('-')"
例如我的是 win32-x64-93。
- 然后到 GitHub 上直接下载预编译好的二进制文件。
- 打开 C:\Users\<你的用户名>\.npmrc 文件，增加下面环境变量（替换成你下载后本地路径），告知npm使用本地二进制文件安装；
sass_binary_path=D:\xxx\win32-x64-93_binding.node
3. 缺少构建工具链
该解决方案慎用，出现几率很小（本人尝试过，发现本人Windows电脑下面工具齐全，本人主要是网络的问题），供大家自查。
问题原因：在某些系统环境下，缺少必要的构建工具链如Python、Visual C++ Build Tools等。
解决方法：
- Windows：确保已安装Microsoft Visual C++ Build Tools或Visual Studio，并包含C++相关组件。
- Linux/Unix：需要确保有GCC和g++编译器，可以通过运行
sudo apt-get install build-essential（Ubuntu/Debian）或相应命令来安装。 - MacOS：通常已经内置了构建工具，若出现问题，则参照具体错误提示，安装缺失的依赖即可。
python3运行node-sass build 失败
2025-01-27 增加该部分 本人在新电脑上试图运行一个老项目，遇到一些问题，分享出来。
刚开始，安装依赖，遇到 node-sass 4.8.3 编译失败。提示：python 不在 windows-build-tools 中。
使用命令npm i -g --production windows-build-tools安装好。
但是继续安装依赖，还是报错。然后使用命令npm config set python D:\Programs\python2\python2.exe写入配置。为此，本人还特意下载了 python2，并参考这篇文章使得系统同时拥有python3。
如此，才总算把python的问题解决了。至于为何不能用 python3，则是另一个问题（node-sass的编译程序使用的 print 语法不带括号，无法被python3解析。）
上述，参考这篇文章www.cnblogs.com/liuyangfirs…
但是这仅仅是一部分，后面又遇到了下面的问题：
gyp ERR! stack Error: 404 response downloading registry.npmmirror.com/dist/v16.20…
只好从 npm 源上下载下来，然后在 .npmrc 中设置 nodedir 配置。参考cloud.tencent.com/developer/a…
但是还是不行。最后是用 nvm 安装了 node v14.21.3 以及变更 sass_binary_path 为 win32-x64-83_binding.node，才最终解决。不能说只需这步就可以，只能说前面的问题不同的电脑及其环境不一定出现而已。
4. 清理缓存与锁定文件
若上述几种方式还是不行，清除缓存试试（删除重装大法）。
问题原因：有时是npm的缓存导致安装失败；或是项目中的package-lock.json锁定文件中依赖关系失效导致安装出错。
解决方法：
- 清理npm缓存：
npm cache clean --force，然后再尝试安装。 - 或者删除项目中的 package-lock.json文件（若有）和 node_modules 文件夹后（若有），再执行
npm install。
通过以上几种最佳实践，大多数情况下都能够成功解决 node-sass安装失败的问题。如果问题依然存在，欢迎讨论，或者查阅 node-sass 最新官方文档或者相关的技术论坛寻求帮助，及时跟进最新解决方案（也许以后再也没有 node-sass 安装失败的烦恼，佛祖保佑，哈哈）。
