2nd/10_Wiki/Topics/Architecture/Extract Method (함수 추출하기).md

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, verification_status, tags, raw_sources, last_reinforced, github_commit, tech_stack

id	title	category	status	canonical_id	aliases	duplicate_of	source_trust_level	confidence_score	verification_status	tags	raw_sources	last_reinforced	github_commit	tech_stack
wiki-2026-0508-extract-method-함수-추출하기	Extract Method (함수 추출하기)	10_Wiki/Topics	verified	self	Extract Function 함수 추출	none	A	0.9	applied	refactoring clean-code method		2026-05-10	pending	language framework typescript refactoring

Extract Method (함수 추출하기)

매 한 줄

"매 code fragment 가 의도를 가질 때, 매 그 의도를 이름으로 만든다". 매 Fowler Refactoring (1999, 2018) 의 매 most-used refactoring — 매 long method 를 작은 well-named function 으로 쪼개 매 readability + reusability 의 동시 확보. 2026 IDE (IntelliJ, VS Code, Cursor) 의 자동 refactor 로 매 cost 가 사실상 0.

매 핵심

매 trigger

• 매 method 가 한 화면을 넘는다.
• 매 comment 로 "이 부분은 X 한다" 라고 설명하고 있다 → 매 그 X 가 method name.
• 매 동일 logic 의 duplication.
• 매 nested conditional 의 가독성 hurt.

매 mechanic (Fowler)

1. 매 새 함수 의 create — intent-revealing name.
2. 매 fragment 를 새 함수로 copy.
3. 매 local variable 의 scope 분석 → parameter / return value 결정.
4. 매 원래 자리에 call 로 replace.
5. 매 test 실행 (매 step 마다).

매 응용

1. Long Method 의 fix.
2. Duplicate Code 의 removal.
3. Replace Temp with Query 의 stepping stone.
4. 매 LLM-assisted refactor 의 safest primitive.

💻 패턴

Before (long method)

function printOwing(invoice: Invoice) {
  let outstanding = 0;
  console.log("***********************");
  console.log("**** Customer Owes ****");
  console.log("***********************");

  for (const o of invoice.orders) outstanding += o.amount;

  const today = new Date();
  invoice.dueDate = new Date(today.getFullYear(), today.getMonth(), today.getDate() + 30);

  console.log(`name: ${invoice.customer}`);
  console.log(`amount: ${outstanding}`);
  console.log(`due: ${invoice.dueDate.toLocaleDateString()}`);
}

After (extracted)

function printOwing(invoice: Invoice) {
  printBanner();
  const outstanding = calculateOutstanding(invoice);
  recordDueDate(invoice);
  printDetails(invoice, outstanding);
}

function printBanner() {
  console.log("***********************");
  console.log("**** Customer Owes ****");
  console.log("***********************");
}

function calculateOutstanding(invoice: Invoice): number {
  return invoice.orders.reduce((sum, o) => sum + o.amount, 0);
}

function recordDueDate(invoice: Invoice) {
  const today = new Date();
  invoice.dueDate = new Date(today.getFullYear(), today.getMonth(), today.getDate() + 30);
}

function printDetails(invoice: Invoice, outstanding: number) {
  console.log(`name: ${invoice.customer}`);
  console.log(`amount: ${outstanding}`);
  console.log(`due: ${invoice.dueDate.toLocaleDateString()}`);
}

Extract with multiple return (TS tuple)

function summarize(xs: number[]): { sum: number; avg: number } {
  return { sum: total(xs), avg: total(xs) / xs.length };
}
function total(xs: number[]) { return xs.reduce((a, b) => a + b, 0); }

Extract from conditional (Decompose Conditional)

// before
if (date.before(SUMMER_START) || date.after(SUMMER_END)) charge = qty * winterRate + winterFee;
else charge = qty * summerRate;

// after
charge = isSummer(date) ? summerCharge(qty) : winterCharge(qty);
function isSummer(d: Date) { return !d.before(SUMMER_START) && !d.after(SUMMER_END); }

IDE shortcut (VS Code / Cursor)

Select code → Cmd+. → "Extract to function in module scope"
# 매 zero-cost — 매 Fowler 가 1999 에 손으로 하던 것

LLM-assisted (Claude Code)

"이 함수에서 outstanding 계산 부분을 calculateOutstanding 으로 extract"
→ 매 LLM 이 mechanic 의 1-5 를 자동 수행 + test 보존 검증

매 결정 기준

상황	Approach
Fragment 에 의도 있음	Extract Method
Single expression with confusing name	Extract Variable
Class 가 너무 비대	Extract Class (after multiple Extract Method)
매 한 번만 쓰이고 trivial	매 inline 유지 — 매 over-extraction 회피

기본값: 매 의심되면 extract — 매 IDE 가 자동, 매 inline 으로 되돌리기도 trivial.

🔗 Graph

• 부모: Refactoring_Best_Practices · Clean Code
• 변형: Extract Class
• Adjacent: Inline Method (매 inverse) · Single Responsibility

🤖 LLM 활용

언제: 매 long method / duplicated block 발견 시 즉시 propose. 언제 X: 매 hot path 의 micro-optimization (function call overhead) — 매 측정 기반.

❌ 안티패턴

• Over-extraction: 매 1-2 line trivial 도 extract → 매 indirection 폭발.
• Bad name: helper1, doStuff — 매 의도 의 표현 실패.
• Hidden side effect: 매 pure name 으로 보이는데 매 mutation 수행.
• Premature extraction without test: 매 mechanic step 5 건너뛰기 → silent regression.

🧪 검증 / 중복

• Verified (Fowler Refactoring 2nd ed. 2018 Ch. 6, Beck Tidy First? 2024).
• 신뢰도 A.

🕓 Changelog

날짜	변경
2026-05-08	Phase 1
2026-05-10	Manual cleanup — Fowler mechanic + modern IDE/LLM workflow 정리