[클린코드 스터디] 1&2장. 클린 코드와 의미 있는 이름

개발을 공부하다 보면 자연스럽게 마주하게 되는 개념, 클린 코드. 그중에서도 『Clean Code』라는 책이 가장 유명하다.

이번에 좋은 기회로 클린코드 스터디를 진행하게 됐다.

각 장의 내용을 블로그에 간단히 정리해볼 예정이고, 오늘은 1장과 2장의 내용을 함께 다뤄보자.

---

1장. 깨끗한 코드

🧼 깨끗한 코드란?

클린 코드를 짜야 한다는 말을 우리는 정말 수도 없이 듣는다.
그런데 왜 그래야 할까? 어떻게 짜는 게 클린 코드일까?

깨끗한 코드가 왜 필요한지는 사실 다들 한 번쯤 겪어봤을 거다.

“한 줄만 고치면 될 줄 알았는데, 모듈 수백 개를 건드리게 됐어요…”
“코드 수정할 때마다 엉뚱한 데서 버그가 나요…”

책에서는 이렇게 말한다.

기한을 맞추는 유일한 방법은, 코드를 깨끗하게 짜는 것뿐이다.
나쁜 코드는 결국 속도를 느리게 한다.

중요한 건, 이걸 단순한 기술 문제가 아니라 ‘전문가로서의 태도’로 본다는 점이다.

개발자도 의사처럼 전문성을 갖춘 책임 있는 직업인이라는 뜻이다.
환자가 시간 없다고 수술 전에 손 씻지 말라고 해도, 의사는 절대 그 말을 따르지 않는다.
그게 환자를 위한 길이고, 자신이 지켜야 할 원칙이기 때문이다.

개발자도 마찬가지다.
기한에 쫓긴다고 해서 나쁜 코드를 그대로 두면 안 된다.
좋은 코드를 지키는 일은 결국 우리 몫이다.

🧠 깨끗한 코드는 어떤 코드일까?

책에서는 여러 유명 개발자들의 생각을 인용해 이렇게 정리한다.

• 잘 읽히는 코드: 마치 잘 쓴 문장처럼
• 하나의 책임만 가진 코드: 각 함수와 클래스가 ‘딱 하나’의 일을 함
• 주의 깊게 짜인 코드: 괜히 손대기 싫을 정도로 완성도가 높은 코드
• 읽는 사람을 배려한 코드: 다른 사람이 쉽게 이해하고 고칠 수 있는 코드

결국 깨끗한 코드는 ‘읽는 사람을 위해 쓴 코드’다.
우리는 코드의 저자니까, 독자를 위한 책임도 있다는 얘기다.

---

2장. 의미 있는 이름

깨끗한 코드의 첫걸음은 바로 이름 짓기에서 시작된다.

우리는 변수, 함수, 클래스, 파일 등 거의 모든 것에 이름을 붙인다.
이름 하나 잘 지으면 코드 이해도 쉬워지고, 협업할 때 설명할 일도 줄어든다!

✅ 이름 짓는 기본 규칙

• 의도를 분명히 드러내라
  int d; → int elapsedTimeInDays;
  → 주석 없이도 무슨 뜻인지 알 수 있도록!
• 함축적인 표현은 피하라
  getThem() → getFlaggedCells()
  → 무슨 걸 가져오는지, 누구를 위한 함수인지 분명하게!
• 그릇된 정보는 주지 마라
  accountList가 실제로 List가 아니라면?
  → accountGroup, accounts 등 더 정확한 표현 사용하기
• 의미 없는 구분은 피하라
  getActiveAccount(), getActiveAccounts(), getActiveAccountInfo()
  → 헷갈리기만 하고 정보는 없음
• 발음 가능한 이름을 써라
  genymdhms → generationTimestamp
  → 코드도 말처럼 자연스럽게 읽혀야 한다
• 검색 가능한 이름을 써라
  MAX_CLASSES_PER_STUDENT는 grep에 잘 잡히지만 7은 아니다

👎 이런 네이밍은 피하자

• a1, a2처럼 연속된 숫자 붙이기
• Info, Data, Object, Variable, Table 같은 불용어 쓰기
• e, l, O처럼 헷갈리는 단일 문자
• HolyHandGrenade() 같은 기발하지만 의미 없는 이름
  
  

🔁 일관성과 맥락도 중요하다

• get, fetch, retrieve를 클래스마다 다르게 쓰면 헷갈림
• 컨트롤러는 Controller, 매니저는 Manager처럼 통일성 있게
• Address, PostalAddress처럼 불명확한 이름보다 더 구체적으로!

그리고 무엇보다 중요한 건, 이름이 맥락 속에서 자연스럽게 의미를 가지는 것.

예를 들어, state라는 변수가 있을 때 이게 주소의 일부인지 혼란스럽다면
→ Address.state처럼 클래스나 이름공간으로 감싸서 명확하게 보여주는 게 좋다.

---

✍️ 마무리하며

깨끗한 코드는 결국 읽기 쉬운 코드, 의도가 명확하게 드러나는 코드다.

이름을 잘 짓는 것만으로도 코드 전체가 깔끔해지고, 협업이 쉬워지고, 버그가 줄어든다.

당장은 귀찮아 보여도, 결국은 가장 빠르고 안전한 길이라는 걸 기억하며 나도 더 나은 개발자가 되기 위해 계속해서 노력해야겠다.