안티패턴(anti-pattern)이란 무엇인가요?

Question

Accepted Answer

**안티패턴(anti-pattern)**은 반복되는 문제에 대한 흔하지만 **나쁜 해결책**입니다 — 합리적으로 보이지만 나쁜 결과(유지보수가 어렵거나, 버그가 많거나, 경직된 코드)로 이어지는 접근 방식입니다. 이를 인식하면 흔한 실수를 피하는 데 도움이 됩니다.

## 안티패턴이란

```text
안티패턴 = 흔히 사용되지만 역효과를 내는 해결책:
  → 해결책처럼 보이지만 더 많은 문제(기술 부채, 버그, 경직성)를 유발함
  → 디자인 패턴(검증된 좋은 해결책)의 반대
→ 이를 인식하면 흔한 함정을 피하는 데 도움이 됨
```

## 흔한 코드/설계 안티패턴

```text
갓 오브젝트/클래스(GOD OBJECT) → 너무 많은 일을 하는 하나의 클래스(거대하고 모든 것을 앎) → 유지보수 어려움;
  단일 책임 위반
스파게티 코드 → 명확한 흐름 없이 얽히고 구조 없는 코드 → 따라가거나 변경하기 어려움
복사-붙여넣기 프로그래밍 → 중복된 코드(DRY 위반) → 버그/변경을 모든 곳에서 고쳐야 함
매직 넘버/스트링 → 설명 없는 리터럴 값 → 불명확하고 오류가 발생하기 쉬움
이른 최적화 → 필요하기 전에 최적화 → 헛된 노력, 복잡성
골든 해머(GOLDEN HAMMER) → 모든 것에 하나의 익숙한 도구/패턴을 남용("망치를 들면...")
하드코딩 → 설정 가능해야 할 값을 코드에 박아 넣음
```

## 프로세스/아키텍처 안티패턴

```text
빅 볼 오브 머드(BIG BALL OF MUD) → 명확한 아키텍처 없음; 모든 것이 얽힘
과도한 엔지니어링 → 필요 없는 곳에 불필요한 복잡성, 추상화, 패턴
카고 컬트(CARGO CULT) → 왜인지 이해하지 못한 채 패턴/관행을 사용
바퀴 재발명; NIH(not invented here); 도처의 강한 결합
→ 안티패턴을 인식 → 그것들을 피해 더 깔끔하고 유지보수 가능한 코드 작성
```

## 왜 중요한가

안티패턴을 이해하는 것은 가치가 있습니다. **흔한 나쁜 해결책을 인식하면 그것들을 피하는 데 도움이 되어** 더 깔끔하고 유지보수 가능한 코드로 이어지므로 유용한 설계 지식이기 때문입니다.

안티패턴은 흔하지만 역효과를 내는 해결책 — 합리적으로 보이지만 더 많은 문제(기술 부채, 버그, 경직성)를 유발하는 접근 방식 — 으로, 본질적으로 디자인 패턴의 반대입니다.

안티패턴이 무엇인지(피해야 할 흔히 사용되는 나쁜 해결책)를 이해하면 개념의 틀이 잡힙니다.

**흔한 코드/설계 안티패턴** — **갓 오브젝트**(너무 많은 일을 하는 하나의 클래스, 단일 책임 위반), **스파게티 코드**(얽히고 구조 없는 코드), **복사-붙여넣기 프로그래밍**(DRY를 위반하는 중복으로, 모든 곳에서 고쳐야 하는 버그 유발), **매직 넘버/스트링**(설명 없는 리터럴), **이른 최적화**(필요하기 전에 최적화), **골든 해머**(모든 것에 하나의 익숙한 도구 남용), **하드코딩** — 을 이해하면 이런 빈번한 코드 수준 실수를 인식하고 피하는 데 도움이 됩니다.

**프로세스/아키텍처 안티패턴** — **빅 볼 오브 머드**(명확한 아키텍처 없음), **과도한 엔지니어링**(필요 없는 곳의 불필요한 복잡성과 패턴 — 패턴을 강제하지 않는 판단과 연결됨), **카고 컬트**(왜인지 이해하지 못한 채 패턴 사용) — 을 이해하면 더 큰 구조적, 프로세스적 실수를 피하는 데 도움이 됩니다.

안티패턴을 인식하는 것이 가치 있는 이유는 그것들이 *흔하기* 때문입니다 — 개발자들이 자연스럽게 빠져듭니다 — 그래서 그것들이 어떻게 보이고 왜 해로운지를 알면 의식적으로 피하고 더 깔끔하고 유지보수 가능한 코드를 작성하는 데 도움이 됩니다.

안티패턴을 이해하는 것은 패턴을 이해하는 것을 보완합니다. 좋은 해결책(패턴)과 나쁜 것(안티패턴)을 모두 알면 설계 판단이 향상됩니다.

흔한 나쁜 해결책(안티패턴)을 인식하면 그것들을 피하고 더 깔끔하고 유지보수 가능한 코드를 작성하는 데 도움이 되고, 안티패턴은 개발자들이 자연스럽게 빠지는 흔한 함정(갓 오브젝트, 스파게티 코드, 중복, 과도한 엔지니어링, 카고 컬트)이며, 그것들을 이해하는 것이 패턴을 아는 것을 보완하므로, 안티패턴을 이해하는 것은 가치 있고 실무적으로 관련 있는 설계 지식입니다. 이는 나쁜 코드로 이어지는 흔한 실수를 인식하고 피하는 데 유용하며, 좋은 패턴에 대한 지식을 보완하고, 코드 품질과 유지보수성을 해치는 빈번한 함정을 피하는 설계 판단에 중요합니다.