单分支 if 语句专用于轻量级前置校验，只拦截非法输入、不处理成功路径；适用于参数非空、格式初筛等守门场景，忌嵌套、副作用及误判假值。
单分支 if 语句最适合做“不满足就立刻拦住”的轻量级前置校验——它不处理成功路径，只专注快速拒绝非法输入，让主逻辑在干净、可信的上下文中运行。
明确校验目标：只拦错，不兜底
单分支的核心价值在于“守门”，不是“决策”。它不负责告诉用户怎么改，也不处理正常流程，只做一件事：发现明显违规就终止执行并返回明确错误。
- 适合场景：参数非空检查、格式初筛（如手机号正则）、基础长度限制、必要头信息是否存在
- 不适合场景：需要根据多个条件选择不同处理路径、需 fallback 行为、涉及数据库查询或远程调用
- 典型错误：在单分支里写 else 处理正常逻辑——这已超出单分支语义，应改用双分支或提前 return
写法要简洁、可读、防踩坑
避免嵌套、避免复杂表达式，每条校验独立成行，条件清晰直白。
- 用显式判空：
if not user_id:而不是if not user_id.strip():（后者对 None 报错） - 手机号校验先保底非空再正则：
if not phone or not re.match(r"^1[3-9]\d{9}$", phone): return reject("手机号格式错误") - HTTP 请求头检查直接用字符串判断：
if not request.headers.get("X-Request-ID"):，不依赖可能为 None 的属性链 - 避免在条件中调用有副作用的函数（如
if log_and_check_token():），单分支条件应是纯判断
与主逻辑解耦：卫语句优先
把所有单分支校验集中放在函数开头，形成一组“守卫语句”（guard clauses）。一旦通过全部校验，后续代码即可默认参数合法、字段非空、结构完整。
- 好处：主逻辑缩进浅、无层层 if 缩进、调试时跳过校验段直接看业务
- 示例结构：
if not data:
return {"error": "请求体为空"}
if not data.get("order_id"):
return {"error": "缺少订单ID"}
if not isinstance(data.get("items"), list) or len(data["items"]) == 0:
return {"error": "商品列表不能为空"}
# ✅ 此处开始放心处理真实业务逻辑
return calculate_discount(data)
注意边界：NULL、None、空字符串、0 值的区分
单分支校验最容易翻车的是把“假值”一概而论。比如金额为 0 是合法业务状态，不能被 if not amount: 拦住。
- 数值型字段需明确判 None：
if amount is None:，而非if not amount: - 字符串字段慎用
if not s:，它会同时拦截""、None、" "；如需严格非空，加 strip：if not (s or "").strip(): - 布尔字段勿用
if status:判断启用/禁用，应写if status is False:或if status != True:
