如何在任意平台Bash环境中安全定位可用Python3解释器

原有实现的缺陷 #

最初的逻辑存在几个明显的兼容性问题：

• 依赖路径字符串匹配/Python3判定Python版本，规则非常脆弱，绝大多数Linux、macOS下的Python3安装路径不会带有该特征串，极易出现误判
• 完全没有覆盖Windows平台官方Python安装包默认提供的py启动器场景，在Git Bash、WSL、MSYS2、Cygwin等Windows常见Bash环境下会识别失败
• 没有做实际的版本校验，极端场景下会兜底到Python2，导致后续任务执行异常
• 依赖外部命令which做命令存在性检测，部分精简系统、嵌入式环境可能没有预装该命令，兼容性不如Bash内置的command -v

可用的通用实现 #

下面的实现可以覆盖所有将Bash、Python加入PATH的常规场景，用户克隆仓库后直接运行setup.sh即可自动完成识别：

# 初始化Python解释器路径变量
python_bin=""

# 按优先级枚举所有可能的Python3调用方式
for cmd in "py -3" python3 python; do
    # 提取调用串中的命令名，检测是否在PATH中存在
    if command -v ${cmd%% *} >/dev/null 2>&1; then
        # 实际校验调用的Python大版本是否为3
        if $cmd -c 'import sys; sys.exit(0 if sys.version_info.major == 3 else 1)' >/dev/null 2>&1; then
            python_bin="$cmd"
            break
        fi
    fi
done

# 兜底校验，未找到可用Python3直接报错退出，避免静默失败
if [ -z "$python_bin" ]; then
    echo "错误：未在PATH中检测到可用的Python3解释器，请先安装Python3并将其添加到系统PATH" >&2
    exit 1
fi

实现说明 #

• 优先级适配Windows环境：首先检测py -3调用，符合Windows平台官方Python启动器的使用规范，强制调用Python3版本，不会误调用系统残留的Python2
• 通用场景优先匹配python3命令，覆盖绝大多数Linux发行版、macOS、Homebrew、apt、yum等常规方式安装的Python3环境
• 最后兜底匹配python命令，但不会直接使用，而是通过内嵌Python代码校验大版本是否为3，从根源避免版本不匹配问题
• 所有命令存在性检测均使用Bash内置语法，无额外外部依赖，兼容所有主流Bash运行环境
• 识别失败直接抛出明确错误并退出，不会带着错误配置继续执行，用户可以第一时间感知环境问题

后续脚本中所有需要调用Python的位置，直接使用$python_bin替代原来的硬编码python/python3即可，例如：

# 安装依赖
$python_bin -m pip install -r requirements.txt
# 执行项目脚本
$python_bin app.py

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