本文详解 Python 脚本无法直接执行（如 ./script.py 报错）的常见原因，重点解决 Shebang 行位置错误、路径格式不规范等核心问题，并提供可立即验证的修复步骤与最佳实践。
本文详解 python 脚本无法直接执行（如 `./script.py` 报错）的常见原因，重点解决 shebang 行位置错误、路径格式不规范等核心问题，并提供可立即验证的修复步骤与最佳实践。
在 Linux/macOS 系统中，要让 Python 脚本通过 ./script.py 直接运行（而非显式调用 python script.py），必须正确配置 Shebang（释伴）行——即脚本第一行以 #! 开头的特殊注释。但实践中，两个看似微小的错误极易导致失败：
✅ 正确写法的硬性要求
- #! 必须是文件的前两个字节：开头不能有任何空格、BOM、空行或注释；
- 路径必须准确且无空格：应写作 /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），避免硬编码路径失效。
⚠️ 常见陷阱与排查
- 隐藏字符问题：用 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免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
