Shell脚本执行node命令提示“node: command not found”的排查疑问

这种情况我之前也碰到过好几次——明明终端里手动跑node -v完全正常，一放到.sh脚本里执行就报找不到命令，就算确认了PATH里有node的路径也没用。除了常见的PATH问题，还有这几个方向可以排查：

• 脚本使用的Shell和当前终端不一致
  比如你当前终端用的是bash，但脚本默认用sh（很多系统里sh是dash的软链接），两者的环境变量可能不一样。可以先在脚本开头加一行echo $PATH，执行脚本后看看输出的PATH和终端里的echo $PATH是不是一致。如果不一样，要么在脚本里指定node的绝对路径（先在终端用which node拿到路径，比如/usr/local/bin/node，然后脚本里用这个路径替代node），要么修改脚本的shebang行，改成和终端一致的Shell，比如把开头的#!/bin/sh改成#!/bin/bash或者#!/usr/bin/env bash。

• 用sudo执行脚本导致环境变量被重置
  如果是用sudo ./your_script.sh运行脚本，sudo会默认重置环境变量为系统默认的PATH，可能不包含你安装node的路径。可以试试用sudo -E ./your_script.sh，这个参数会保留当前用户的环境变量；或者直接在脚本里用node的绝对路径执行。

• node是通过版本管理器（nvm/n/volta等）安装的
  这类工具通常是在用户的Shell配置文件（比如.bashrc、.zshrc）里设置的环境变量，但脚本执行时如果是非交互式Shell，不会自动加载这些配置文件。解决方法有两个：要么在脚本开头手动加载版本管理器的配置，比如nvm的话加source ~/.nvm/nvm.sh；要么直接用版本管理器对应的node绝对路径，比如~/.nvm/versions/node/v18.17.0/bin/node（替换成你自己的版本号）。

• 检查脚本的执行方式
  如果你是用sh your_script.sh强制用sh执行，而不是./your_script.sh（依赖shebang行），也可能导致Shell环境不同。试试用./your_script.sh执行，前提是脚本已经加了可执行权限（chmod +x your_script.sh）。

备注：内容来源于stack exchange，提问作者Danyx