本文详解 Python 脚本无法直接执行（如 ./script.py 报错）的常见原因，重点解决 Shebang 行位置错误、路径格式不规范等核心问题，并提供可立即验证的修复步骤与最佳实践。

本文详解 python 脚本无法直接执行（如 `./script.py` 报错）的常见原因，重点解决 shebang 行位置错误、路径格式不规范等核心问题，并提供可立即验证的修复步骤与最佳实践。

在 Linux/macOS 系统中，要让 Python 脚本通过 ./script.py 直接运行（而非显式调用 python script.py），必须正确配置 Shebang（释伴）行——即脚本第一行以 #! 开头的特殊注释。但实践中，两个看似微小的错误极易导致失败：

✅ 正确写法的硬性要求

1. #! 必须是文件的前两个字节：开头不能有任何空格、BOM、空行或注释；
2. 路径必须准确且无空格：应写作 /usr/bin/python 或更推荐的 /usr/bin/env python，而 /usr/bin python（含空格）是非法语法，会导致 bad interpreter 错误。

? 修复步骤（以 Ubuntu 为例）

假设你的脚本名为 hello.py，请按以下顺序操作：

# 1. 编辑脚本，确保第一行严格为（无空行、无缩进）：
#!/usr/bin/env python
print("Hello, World!")

# 2. 保存后赋予可执行权限
chmod +x hello.py

# 3. 直接运行（无需 python 命令）
./hello.py

? 推荐使用 #!/usr/bin/env python 而非 #!/usr/bin/python：它通过环境变量查找 python 可执行文件，兼容虚拟环境和多版本 Python（如 python3），避免硬编码路径失效。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

⚠️ 常见陷阱与排查

• 隐藏字符问题：用 head -n1 hello.py | cat -A 检查首行是否含 ^M（Windows 换行）或前导空格（显示为 ^I 或空格）；
• 编码 BOM：UTF-8 with BOM 会在文件开头插入不可见字节，导致 #! 失效；建议用 VS Code 或 vim 保存为 UTF-8 without BOM；
• 权限缺失：chmod +x 不可省略，否则系统拒绝执行；
• 解释器路径错误：运行 which python 确认实际路径，若为 python3，则需写 #!/usr/bin/env python3。

✅ 验证是否生效

# 查看脚本第一行原始字节（确认无干扰字符）
hexdump -C hello.py | head -n 2
# 正常输出应以 "23 21"（即 #!）开头

# 检查解释器是否被正确识别
strace -e trace=execve ./hello.py 2>&1 | grep execve
# 成功时会显示 execve("/usr/bin/python", ...)

遵循以上规范，即可彻底解决 “Unable to execute Python Script directly” 问题。核心原则始终是：Shebang 是操作系统级指令，对格式零容忍——精简、精准、无冗余。

立即学习“Python免费学习笔记（深入）”；