执行npm脚本build-css成功，直接运行node-sass CLI命令却失败

这问题我之前也碰到过，核心原因其实是yarn运行脚本时会自动处理本地依赖的可执行文件路径，但直接在shell里跑命令时，系统找不到本地包的位置——别慌，一步步来排查解决：

1. 确认node-sass是本地项目依赖，而非全局安装 #

yarn的脚本会自动优先调用项目node_modules/.bin目录下的可执行文件，但直接在shell输入命令时，系统只会去PATH里找全局的可执行文件。如果你的node-sass只装在项目本地（也就是package.json的devDependencies里），直接跑就会提示找不到。

• 先检查package.json的devDependencies里有没有node-sass，如果没有，执行：

  yarn add node-sass --dev
  

• 如果已经有，尝试修复可能损坏的本地依赖：

  # 删除旧的依赖包和锁定文件
  rm -rf node_modules yarn.lock
  # 重新安装依赖
  yarn install
  

  或者更快捷的强制更新：

  yarn install --force
  

2. 直接执行时指定本地node-sass的完整路径 #

不想折腾环境变量的话，直接用本地依赖的路径执行命令，和yarn脚本用的是同一个版本：

./node_modules/.bin/node-sass [你的原命令参数]

比如你的build-css脚本是node-sass src/ -o dist/，直接跑就是./node_modules/.bin/node-sass src/ -o dist/。

3. 把本地依赖路径加入系统PATH #

如果不想每次都写全路径，可以临时把node_modules/.bin加入当前shell的PATH：

export PATH="./node_modules/.bin:$PATH"

之后再直接输入node-sass命令就能找到本地版本了。如果想永久生效，把这句加到你的shell配置文件里：

• Bash用户：编辑~/.bashrc或~/.bash_profile
• Zsh用户：编辑~/.zshrc
  保存后重启shell，或者执行source ~/.bashrc（对应你的配置文件）生效。

4. 检查Node版本是否兼容 #

node-sass对Node版本有严格的对应关系，如果近期你切换过Node版本，可能导致本地的node-sass二进制文件失效：

• 查看当前Node版本：node -v
• 简单对应规则：node-sass 4.x适配Node 8-12，5.x适配Node 12-14，6.x适配Node 14+
• 如果版本不兼容，要么用nvm切换回原来的Node版本，要么升级/降级node-sass到对应兼容版本。

最后核对脚本定义 #

确认你的package.json里的build-css脚本没有特殊语法，就是普通的node-sass命令，比如：

"scripts": {
  "build-css": "node-sass src/css/main.scss dist/css/main.css"
}

如果脚本里有npx前缀，直接跑的时候也要加上，但一般yarn脚本不需要额外前缀。

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