#!/usr/bin/env python3这行叫做Shebang也叫 Hashbang它的作用和编码声明完全不同但经常一起出现在Python文件的开头。 Shebang 的作用告诉操作系统如何执行这个文件在 Linux/macOS 下的意义当你给一个.py文件加上执行权限chmod x script.py然后直接运行./script.py时操作系统需要知道用什么解释器来执行这个文件Shebang 就是答案#!/usr/bin/env python3的含义分解部分含义#!魔法标记告诉操作系统下面这行是解释器的路径/usr/bin/env环境查找器会在系统的PATH环境变量中搜索python3要查找的程序名称Python 3 解释器为什么不直接写#!/usr/bin/python3/usr/bin/env python3更灵活会使用用户在虚拟环境中安装的 Python 3而#!/usr/bin/python3强制使用系统路径的 Python不够通用在 Windows 下的表现重要Windows 原生不支持 ShebangWindows 下文件关联靠的是文件扩展名.py关联到 Python 解释器直接双击或python script.py运行但在 Windows 上 Shebang 也不是完全没用跨平台工具如 Git Bash、WSL、Cygwin会解析 ShebangPython 解释器本身会读取 Shebang作为注释用于指定编码等某些 IDE 和工具链会参考 Shebang Shebang vs. 编码声明完整对比️ 标准文件头结构一个完整的跨平台 Python 文件头通常是这样#!/usr/bin/env python3 # -*- coding: utf-8 -*- 模块文档字符串 这里写这个文件的功能说明 import sys import os # ... 其他导入顺序要求Shebang可选仅当需要直接运行时编码声明必须放在第一或第二行文档字符串导入模块❌ 常见错误示例# 错误1编码声明在 Shebang 之前 # -*- coding: utf-8 -*- # ❌ 如果这是第1行Shebang 必须在第1行 #!/usr/bin/env python3 # 错误2编码声明在第三行或更后 #!/usr/bin/env python3 import sys # -*- coding: utf-8 -*- # ❌ 太晚了解释器已经按默认编码读取了✅ 正确示例#!/usr/bin/env python3 # -*- coding: utf-8 -*- # 或者如果不需要 Shebang # -*- coding: utf-8 -*- 实际应用场景场景1开发跨平台命令行工具#!/usr/bin/env python3 # -*- coding: utf-8 -*- def main(): print(你好世界) if __name__ __main__: main()Linux/macOS 用户chmod x tool.py ./tool.pyWindows 用户python tool.py场景2PyPI 发布的包通常不包含 Shebang因为安装时会自动生成但必须包含编码声明兼容 Python 2场景3Jupyter Notebook 或交互式环境不需要任何文件头环境已处理 总结表格特性Shebang (#!/usr/bin/env python3)编码声明 (# -*- coding: utf-8 -*-)目标读者操作系统/ShellPython 解释器作用指定解释器路径指定源文件编码必要位置第 1 行第 1 或 2 行Linux/macOS✅ 直接运行脚本时必需⚠️ Python 2 必需Python 3 可选Windows❌ 原生不支持⚠️ 同左典型写法#!/usr/bin/env python3# -*- coding: utf-8 -*-如果不写无法直接./script.py运行Python 2 报错Python 3 正常 最佳实践建议写命令行工具同时包含 Shebang 和编码声明写库/模块只需编码声明Shebang 会被忽略只用 Python 3编码声明可选但建议保留跨平台开发两个都写上养成好习惯虚拟环境始终使用/usr/bin/env python3而非绝对路径这样你的 Python 脚本就能在 Windows、Linux、macOS 上优雅运行同时完美支持中文了