NULL

The Sin

它最爱说的话是：我只是把它改成可空参数，方便你以后扩展。

它真正做的事情是，把原本清晰的输入契约改成一团雾。今天是 optional，明天是 null，后天是 undefined，最后连函数自己都不知道自己到底要什么。

The Smell

type CreateInvoiceInput = {
  id?: string | null | undefined;
  userId?: string | null | undefined;
  amount?: number | null | undefined;
  currency?: string | null | undefined;
  metadata?: {
    source?: string | null | undefined;
    region?: string | null | undefined;
  } | null | undefined;
} | null | undefined;

export function createInvoice(input?: CreateInvoiceInput | null | undefined) {
  return persistInvoice({
    id: input?.id ?? null,
    userId: input?.userId ?? null,
    amount: input?.amount ?? null,
    currency: input?.currency ?? null,
    metadata: input?.metadata ?? null,
  });
}

The Reading

这张牌出现时，意味着你的 agent 已经不再相信“必填”这两个字。它会把所有边界条件推给未来的调用方，再用一脸无辜的表情说：我已经给你留扩展空间了。