Windows下Git Bash中NodeJS版本检测Shell脚本失效排查

原因分析 #

• Git Bash在Windows下模拟POSIX终端，但Windows版NodeJS和Git Bash的tty处理存在兼容问题，直接执行node -v时会弹出「stdout is not a tty」的异常提示，导致版本提取脚本拿到错误值（比如0），进而误判版本过低。
• 若你的版本检测脚本用到了依赖终端特性的命令（如read或部分管道操作），在Git Bash的非tty环境下执行也会触发异常，导致版本解析失败。

解决办法 #

1. 优化版本检测逻辑 #

修改脚本，避免异常提示干扰版本提取，同时用更稳定的方式解析版本号：

# 重定向错误输出，提取并去除版本号前的v
NODE_VERSION=$(node -v 2>/dev/null | sed 's/v//')
# 拆分出主版本号
MAJOR_VERSION=$(echo "$NODE_VERSION" | cut -d. -f1)
# 版本校验
if [ "$MAJOR_VERSION" -lt 11 ]; then
    echo "NodeJS版本需11及以上，当前版本: v$NODE_VERSION"
    exit 1
fi

2. 用winpty适配终端 #

Git Bash自带的winpty工具可以解决Windows程序与POSIX终端的交互问题，包装Node命令后再提取版本：

NODE_VERSION=$(winpty node -v | sed 's/v//')

3. 确保PATH配置正确 #

有时Git Bash不会完全继承Windows的系统PATH，可在脚本开头手动添加Node的安装路径：

# 替换为你实际的Node安装目录
export PATH="/c/Program Files/nodejs/:$PATH"

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