来源：网络

还在重复输入 python script.py？掌握这个 Unix 魔法，让你的 Python 脚本拥有与 Shell 脚本同等的"特权"。

为什么你的脚本还不够"酷"？

想象一下这个场景：你写了一个超棒的设备连接脚本，每次使用时却要输入：

python3 harmony-device-connector.py --device HUAWEI_P40

而你的同事使用 Shell 脚本时，只需要：

./deploy.sh --env production

为什么 Python 脚本不能像 Shell 脚本一样"直接执行"？ 答案就在两个神奇的字符中：#!

揭秘：Shebang（Hashbang）的魔力

Shebang 是什么？

Shebang（又称 Hashbang）是 Unix/Linux 系统中的一个魔法注释，格式简单却功能强大：

#!/usr/bin/env python3# 或#!/usr/bin/python3

当你将这两个字符放在脚本文件开头时，你就赋予了脚本"自解释"的能力。

内核的秘密握手协议

当你执行 ./script.py 时，发生了一件有趣的事情：

1. Linux 内核：检查文件前两个字节
2. 发现 "#!"：哦，这是个脚本，需要解释器！
3. 读取后续路径：找到 /usr/bin/env python3
4. 实际执行：/usr/bin/env python3 ./script.py

这就是为什么你不需要手动输入 python 前缀的原因——内核已经帮你做好了！

实战：三步创建"可直接执行"的 Python 脚本

第一步：正确的 Shebang 写法

强烈推荐使用 env 查找法：

#!/usr/bin/env python3

为什么这是最佳实践？

• ✅ 兼容不同系统（Ubuntu、macOS、CentOS）
• ✅ 尊重用户的 Python 环境配置
• ✅ 支持虚拟环境中的 Python

其他写法（了解但不推荐）：

#!/usr/bin/python3          # Ubuntu/Debian 系统#!/usr/local/bin/python3    # macOS 系统默认#!/opt/homebrew/bin/python3 # macOS Homebrew 安装

第二步：完整的脚本模板

#!/usr/bin/env python3# -*- coding: utf-8 -*-"""harmony-device-connector.pyHarmonyOS 设备连接与调试工具作者：你的名字版本：1.0.0"""import sysimport argparseimport subprocessimport loggingfrom pathlib import Pathdefsetup_logging():"""配置专业日志输出"""    logging.basicConfig(        level=logging.INFO,        format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',        datefmt='%Y-%m-%d %H:%M:%S'    )return logging.getLogger(__name__)defcheck_adb_devices():"""检查连接的 ADB 设备"""try:        result = subprocess.run(            ["adb", "devices"],            capture_output=True,            text=True,            timeout=10        )return result.stdoutexcept subprocess.TimeoutExpired:return"超时：无法获取设备列表"except FileNotFoundError:return"错误：adb 命令未找到，请确保已安装 Android SDK"defmain():"""主函数：处理命令行参数和业务逻辑"""    logger = setup_logging()# 创建专业的参数解析器    parser = argparse.ArgumentParser(        description='HarmonyOS 设备连接工具',        epilog='示例：./harmony-device-connector.py --device HUAWEI_P40 --log-level DEBUG'    )    parser.add_argument('--device', help='指定设备型号')    parser.add_argument('--log-level', default='INFO',                        choices=['DEBUG', 'INFO', 'WARNING', 'ERROR'],                       help='设置日志级别')    parser.add_argument('--timeout', type=int, default=30,                       help='操作超时时间（秒）')    args = parser.parse_args()    logger.setLevel(getattr(logging, args.log_level))    logger.info(f"启动 HarmonyOS 设备连接工具")    logger.info(f"参数：device={args.device}, timeout={args.timeout}s")# 检查设备连接    devices_output = check_adb_devices()    logger.debug(f"ADB 输出：\n{devices_output}")if"device"in devices_output:        logger.info("✅ 设备连接成功")# 这里添加你的设备操作逻辑return0else:        logger.error("❌ 未检测到可用设备")return1if __name__ == "__main__":    exit_code = main()    sys.exit(exit_code)

第三步：赋予执行权限并运行

# 1. 添加执行权限（让文件可执行）chmod +x harmony-device-connector.py# 2. 像 Shell 脚本一样直接运行！./harmony-device-connector.py --device HUAWEI_P40# 3. 查看帮助文档./harmony-device-connector.py --help

高级技巧：像系统命令一样使用你的脚本

技巧一：放入 PATH，随处调用

# 1. 创建个人命令目录（如果不存在）mkdir -p ~/.local/bin# 2. 复制脚本并去掉 .py 后缀（更像系统命令）cp harmony-device-connector.py ~/.local/bin/hdc# 3. 添加到 PATH（添加到 ~/.bashrc 或 ~/.zshrc）echo'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrcsource ~/.bashrc# 4. 现在可以在任何目录直接调用！hdc --device HUAWEI_P40

技巧二：与 Makefile 完美集成

# Makefile.PHONY: connect deploy testconnect:    ./harmony-device-connector.py --device HUAWEI_P40deploy:    ./deploy.py --env staging --paralleltest:    ./run_tests.py --unit --integration --coverageclean:    ./cleanup.py --all

技巧三：创建脚本集合（Unix 哲学）

# 项目结构bin/├── hdc          # 设备连接├── deploy       # 部署脚本├── backup       # 备份工具└── monitor      # 监控脚本# 统一调用方式./bin/hdc --help./bin/deploy production

为什么专业开发者都爱用 Shebang？

理由一：极致的开发体验

之前：

python3 src/tools/device_connector.py --ip 192.168.1.100 --port 5555

之后：

./tools/device-connector --ip 192.168.1.100# 或者device-connector --ip 192.168.1.100

理由二：无缝的团队协作

新成员加入项目时，不需要记忆：

• "这个脚本是用 python2 还是 python3 写的？"
• "需要什么特殊的命令行参数才能运行？"

只需要：

./setup-environment  # 一切就绪

理由三：跨平台的一致性

无论是在：

• Ubuntu 服务器
• macOS 开发机
• WSL2 中的 Linux
• Docker 容器

你的脚本都能以相同的方式运行。

最佳实践清单

1. 总是使用 Shebang

   #!/usr/bin/env python3

2. 添加文件编码声明（Python 3 默认是 UTF-8，但显式声明更清晰）

   # -*- coding: utf-8 -*-

3. 使用专业的参数解析

   import argparse  # 而不是手动处理 sys.argv

4. 实现正确的退出码

   if __name__ == "__main__":    sys.exit(main())  # 0 表示成功，非 0 表示失败

5. 控制文件权限

   chmod 755 script.py    # 所有人可读可执行chmod 700 script.py    # 仅自己可执行（敏感脚本）

真实场景对比

场景：日常开发工作流

没有 Shebang 的日常：

$ cd ~/projects/harmony-sdk$ python3 tools/device_manager.py list$ python3 tools/device_manager.py connect --serial 123456$ python3 tools/log_collector.py --output logs/

使用 Shebang 的优雅体验：

$ cd ~/projects/harmony-sdk$ ./tools/device-manager list$ ./tools/device-manager connect --serial 123456$ ./tools/log-collector --output logs/

更进一步的体验：

# 将工具目录加入 PATH$ export PATH="$HOME/projects/harmony-sdk/tools:$PATH"# 在任何地方直接调用$ device-manager --help$ log-collector --output ./debug-logs

从今天开始改变你的脚本习惯

Shebang 不仅仅是两个字符——它是一种思维方式，是 Unix 哲学"万物皆文件"的体现。当你赋予 Python 脚本直接执行的能力时：

1. 你提高了效率：减少打字，降低出错
2. 你提升了专业性：脚本更像"一等公民"
3. 你遵循了标准：与整个 Unix/Linux 工具链保持一致
4. 你改善了协作：让团队成员更容易使用你的工具

立即行动

打开你最近写的一个 Python 脚本，在文件顶部添加：

#!/usr/bin/env python3

然后在终端执行：

chmod +x 你的脚本.py./你的脚本.py

感受一下这种流畅的体验。这就是专业开发者的日常——用最小的摩擦，创造最大的价值。

记住：好的工具应该隐形，让你的注意力集中在真正重要的事情上。Shebang 就是让工具"隐形"的那一步。

扩展阅读：

• Unix 哲学：https://en.wikipedia.org/wiki/Unix_philosophy
• Python 打包指南：https://packaging.python.org/
• argparse 官方文档：https://docs.python.org/3/library/argparse.html

有问题或想分享你的 Shebang 使用经验？欢迎在评论区留言！

长按或扫描下方二维码，免费获取 Python公开课和大佬打包整理的几百G的学习资料，内容包含但不限于Python电子书、教程、项目接单、源码等等
▲扫描二维码-免费领取