如何编写具备可移植性的Python 3 Shebang？

不同系统里python和python3的指向确实存在差异——比如Ubuntu 22.04默认把python链接到Python 3，而部分旧环境或自定义配置里python可能还指向Python 2。下面分享几种兼顾兼容性的shebang写法：

1. 优先调用python3，失败则 fallback到python #

利用shell和Python的注释特性，可以写一个双兼容的shebang：

#!/usr/bin/env sh
''''exec python3 "$0" "$@" # '''
''''exec python "$0" "$@" # '''

工作逻辑：shell执行时会先尝试调用python3，如果找不到就调用python，并把脚本本身和参数传递给对应的Python解释器。Python会把后面的行当作字符串注释，不会影响脚本执行。

2. 使用Python Launcher（跨平台通用） #

如果系统安装了Python的py launcher（Windows默认自带，Linux可通过包管理器安装python3-launcher，macOS用Homebrew安装python-launcher），可以直接指定版本：

#!/usr/bin/env py -3

这个launcher会自动扫描系统中的Python 3版本，不管它在PATH里叫python还是python3，都能正确调用。

3. 自定义检测脚本 #

如果需要更灵活的逻辑，可以写一个前置检测的shell脚本：

#!/usr/bin/env bash
# 遍历候选命令，找到第一个存在的Python 3
for cmd in python3 python; do
    if command -v "$cmd" >/dev/null 2>&1; then
        # 检查是否为Python 3
        if "$cmd" -c "import sys; sys.exit(0 if sys.version_info >= (3,0) else 1)"; then
            exec "$cmd" "$0" "$@"
        fi
    fi
done
echo "Error: 未找到可用的Python 3解释器" >&2
exit 1

这个脚本不仅会找python3和python，还会额外验证是否为Python 3，避免误调用Python 2。

额外保障：脚本内版本检测 #

不管用哪种shebang，都建议在Python脚本开头加上版本检测代码，彻底避免Python 2执行的情况：

import sys
if sys.version_info < (3, 0):
    sys.exit("此脚本需要Python 3环境，请检查你的解释器版本")

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