四、主模块执行控制:优雅的脚本结构
Python脚本的入口点设计直接影响退出码管理。标准模式如下:
import sys
def main():
"""主逻辑函数"""
try:
# 业务逻辑
result = process_data()
if result is None:
print("处理失败")
return 1 # 返回状态码给调用者
print("处理成功")
return 0
except FileNotFoundError as e:
print(f"文件未找到: {e}", file=sys.stderr)
return 2
except Exception as e:
print(f"未预期错误: {e}", file=sys.stderr)
return 70
if __name__ == "__main__":
sys.exit(main())
此结构优势:
main()返回整数状态码,便于单元测试- 错误信息输出到
stderr,与标准输出分离 - 支持模块导入而不执行主逻辑
4.1 与模块导入的兼容性
当脚本被其他模块导入时,if __name__ == "__main__":确保主逻辑不执行。例如:
# utils.py
def main():
print("Hello from utils")
return 0
if __name__ == "__main__":
import sys
sys.exit(main())
此时在其他脚本中import utils不会触发打印,而直接运行python utils.py时正常执行。
4.2 命令行参数驱动的退出码
结合argparse可实现更精细的错误处理:
import sys
import argparse
def main():
parser = argparse.ArgumentParser(description="示例工具")
parser.add_argument("input_file", help="输入文件路径")
parser.add_argument("--verbose", action="store_true", help="详细模式")
try:
args = parser.parse_args()
if not os.path.exists(args.input_file):
parser.error(f"文件不存在: {args.input_file}")
# parser.error()会打印错误并调用sys.exit(2)
if args.verbose:
print(f"处理文件: {args.input_file}")
# 业务逻辑
return 0
except SystemExit as e:
# 保留argparse的退出码
raise
if __name__ == "__main__":
main()
argparse在参数错误时自动调用sys.exit(2),无需额外处理。