在 Click 的 @click.group() 结构中，子命令可通过 ctx.exit(code) 主动终止并返回指定退出码，无需手动向主函数传递；Click 会自动将该码透传至 shell，确保脚本行为符合 Unix 退出约定。
在 click 的 `@click.group()` 结构中，子命令可通过 `ctx.exit(code)` 主动终止并返回指定退出码，无需手动向主函数传递；click 会自动将该码透传至 shell，确保脚本行为符合 unix 退出约定。
Click 默认不会将子命令的退出码“返回”给 @group 装饰的主函数——因为主函数本身不参与命令执行流程的终点控制。真正决定进程退出码的是最后执行的命令上下文（ctx）。因此，关键在于：在子命令中使用 ctx.exit(n) 而非 sys.exit(n) 或 raise SystemExit(n)。
ctx.exit() 是 Click 提供的安全退出机制：它会触发完整的上下文清理（如 @click.pass_context 链中的 close()、reset() 等），并确保退出码被正确捕获和传播。相比之下，sys.exit() 会绕过 Click 的生命周期管理，可能导致资源泄漏或异常堆栈暴露。
以下为推荐实现方式：
import click
@click.group()
@click.pass_context
def main(ctx: click.Context):
"""主命令组入口 —— 无需处理退出码，仅作路由分发"""
pass
@main.command()
@click.pass_context
def get(ctx: click.Context):
"""获取资源示例：失败时返回退出码 1"""
try:
# 模拟业务逻辑
result = fetch_data() # 假设此函数可能抛出异常或返回错误状态
if not result:
ctx.exit(1) # 显式退出，shell 将收到 exit code 1
print("Success")
except Exception as e:
click.echo(f"Error: {e}", err=True)
ctx.exit(1)
@main.command()
@click.pass_context
def deploy(ctx: click.Context):
"""成功场景：返回 0（默认值可省略）"""
do_deploy()
ctx.exit(0) # 或直接 return（Click 默认返回 0）⚠️ 注意事项：
-
必须显式添加
@click.pass_context到每个需要控制退出码的子命令（包括main），否则ctx参数不可用； -
ctx.exit()接收整数退出码（通常0表示成功，非0表示失败），不支持字符串； - 不要混用
sys.exit()和ctx.exit()：前者破坏 Click 上下文，后者是唯一受支持的标准方式； - 若子命令未调用
ctx.exit()，Click 默认以0结束，因此显式调用是表达失败语义的必要手段。
总结：Click 的退出码传播本质是“上下文终结权移交”——主 group 函数仅负责初始化和分发，真正的退出决策权交由最终执行的子命令通过 ctx.exit() 完成。这既符合 CLI 工具的设计惯例，也保障了框架级资源管理的完整性。
