升级三年前Rails+React项目时npm安装及启动报错求助

针对gyp: Undefined variable standalone_static_library in binding.gyp错误 #

这个问题核心是旧版node-sass与新版Node.js不兼容——三年前的node-sass版本依赖的gyp配置变量，在新版Node或node-sass中已被移除或修改。有两个解决方向：

方案1：回退Node.js到兼容版本 #

1. 查看项目package.json中node-sass的版本：
   • 若node-sass是^4.x.x，对应Node.js版本为10-14
   • 若node-sass是^5.x.x，对应Node.js版本为12-16
2. 使用nvm安装并切换到对应版本：

   nvm install 14
   nvm use 14
   

3. 清除缓存后重新安装依赖：

   rm -rf node_modules package-lock.json
   npm cache clean --force
   npm install
   

方案2：替换node-sass为sass（推荐） #

node-sass已停止维护，dart-sass（npm包名为sass）是官方替代，无需编译可彻底避免gyp相关问题：

1. 卸载旧依赖：

   npm uninstall node-sass node-sass-chokidar
   

2. 安装sass：

   npm install sass --save-dev
   

3. 替换package.json中的启动脚本：
   原脚本中类似node-sass-chokidar src/ -o src/的命令，替换为：

   sass src/ src/ --watch
   

   若原脚本是并行执行（比如结合Rails启动），调整为：

   "scripts": {
     "start": "npm-run-all -p watch-css start-rails",
     "watch-css": "sass src/styles:src/styles --watch",
     "start-rails": "rails s"
   }
   

针对sh: node-sass-chokidar: command not found错误 #

这个错误是因为node-sass-chokidar依赖node-sass，若node-sass安装失败，它也会安装不完整。除了上述替换方案外，若坚持使用旧工具：

1. 确保node-sass-chokidar在package.json的devDependencies中，版本与node-sass匹配（比如node-sass-chokidar@1.5.0对应node-sass@4.x）
2. 强制清除缓存后重装：

   npm cache clean --force
   rm -rf node_modules package-lock.json
   npm install
   

额外检查 #

若项目使用Rails Webpacker，需确认config/webpack/environment.js中的sass loader配置已适配sass：

const { environment } = require('@rails/webpacker')
const sassLoader = environment.loaders.get('sass')
sassLoader.use.splice(-1, 0, {
  loader: 'sass-loader',
  options: {
    implementation: require('sass')
  }
})
module.exports = environment

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