---
id: guard-clauses
title: 가드 조항으로 중첩 줄이기 (Guard Clauses)
category: Coding
status: draft
canonical_id: guard-clauses
aliases: [early return, fail fast, precondition check, 조기 리턴]
duplicate_of: null
source_trust_level: C
confidence_score: 0.85
verification_status: conceptual
created_at: 2026-05-09
updated_at: 2026-05-09
last_reinforced: 2026-05-09
review_reason: ""
merge_history: []
tags: [coding, control-flow, readability, refactoring, vibe-coding]
raw_sources: ["P-Reinforce session 2026-05-09 — bulk Coding seed batch 1"]
tech_stack:
  language: "TypeScript / JavaScript / Python / Go"
  applicable_to: ["Backend", "Frontend", "Scripts"]
applied_in: []
---

# 가드 조항으로 중첩 줄이기

> 함수 본문은 "정상 경로 한 줄"에 가깝게 만든다. 비정상 조건은 모두 위로 보내고 즉시 return / throw.

## 📖 핵심 개념

**가드 조항(guard clause)** 은 함수의 시작 부분에 놓는 빠른 종료 분기다. `if (조건 위반) return;` 형태로 비정상 입력·상태를 먼저 거른 뒤, 함수 본문 나머지는 "정상 경로 가정" 으로 작성한다.

핵심 효과:
- 들여쓰기 깊이 감소 → 인지 부하 감소
- 정상 경로가 함수 끝에 모이므로 핵심 로직이 읽기 쉬움
- 각 가드는 독립적인 invariant 표현 → 테스트가 각 분기를 좁게 잡을 수 있음

## 💻 코드 패턴

**나쁜 예 — 화살표 모양**:
```ts
function publish(post: Post): Result {
  if (post) {
    if (post.author) {
      if (post.author.verified) {
        if (post.body.length > 0) {
          return doPublish(post);
        } else {
          return { ok: false, reason: 'EMPTY_BODY' };
        }
      } else {
        return { ok: false, reason: 'UNVERIFIED' };
      }
    } else {
      return { ok: false, reason: 'NO_AUTHOR' };
    }
  } else {
    return { ok: false, reason: 'NO_POST' };
  }
}
```

**가드 조항 적용**:
```ts
function publish(post: Post): Result {
  if (!post) return { ok: false, reason: 'NO_POST' };
  if (!post.author) return { ok: false, reason: 'NO_AUTHOR' };
  if (!post.author.verified) return { ok: false, reason: 'UNVERIFIED' };
  if (post.body.length === 0) return { ok: false, reason: 'EMPTY_BODY' };

  return doPublish(post);
}
```

## 🤔 의사결정 기준

| 상황 | 가드 조항 적합 | 분기문 적합 |
|---|---|---|
| 비정상 입력을 일찍 걸러야 함 | ✅ | ❌ |
| 분기 두 갈래가 비슷한 비중을 가짐 | ❌ | ✅ |
| 두 분기 모두 후속 로직이 길고 비슷함 | ❌ (전략 패턴 고려) | — |
| 가드 위반 시 cleanup 필요 | ✅ + try/finally | — |
| 성능이 극단적으로 중요한 핫패스 | ✅ (조기 종료가 빠름) | — |

## ❌ 안티패턴

- **`else` 가 따라붙는 가드**: `if (!x) return; else { ... }` — `else`는 무의미. 본문은 그냥 다음 줄로.
- **가드 안에서 추가 로직 수행**: 가드는 "검사 + 종료"만. 부작용을 가드에 끼워넣으면 함수 시작부에 숨겨진 동작이 생김.
- **타입 좁히기 누락**: TypeScript에서 `if (!x) return;` 후에는 `x`가 non-nullish로 좁혀져야 한다. 타입 가드(`x is Foo`) 형태가 필요하면 별도 helper로.
- **너무 많은 가드 (6개 이상)**: 함수가 너무 많은 invariant를 책임지고 있다는 신호. 입력을 먼저 정규화하거나 별도 validator로 추출.

## 🤖 LLM 활용 힌트

- LLM에게 함수 작성을 시킬 때 "**가드 조항 우선, else 사용 금지**" 라고 명시하면 화살표 코드를 거의 안 만든다.
- 기존 코드 리팩터링을 시킬 때는 "들여쓰기 4단계 이상이면 가드로 펼쳐줘" 라고 구체적 임계값을 줘야 일관성이 생김.

## 🧪 검증 상태

- verification_status: `conceptual`
- 일반 코딩 베스트 프랙티스(Refactoring 책, Clean Code 등)에서 표준 패턴.
- 실제 적용 사례는 코드베이스에서 발견되면 `applied_in` 에 추가.

## 🔗 관련 문서

- [[Pure_Functions_in_Practice]]
- [[Null_Safety_Patterns]]
- [[Error_Handling_Result_vs_Throw]]
