Antigravity Agent
108 lines
4.0 KiB
Markdown
108 lines
4.0 KiB
Markdown
---
|
|
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]]
|