[클린코드] 2장 의미있는 이름

책에서 기억하고 싶은 내용을 써보세요.

• 좋은 이름
  • 의도가 분명히 드러나는 이름(길어도 상관 없다.)
  • 그릇된 정보를 제공하지 않는 이름(다른 뜻으로 오해할 수 있는 이름 사용 금지)
• 의미있게 구분하기 : 이름이 달라지면 의미도 달라져야 한다.
• 발음하기 쉬운 이름 사용하기 : 커뮤니케이션을 위해 발음하기 쉬운 이름은 중요하다.
• 검색하기 쉬운 이름을 사용하기
  • 긴 이름이 짧은 이름보다 검색에 용이하다.
  • 이름 길이는 범위 크기에 비래해야 한다.
• 자신의 기억력을 자랑하지 마라. (이름을 자신만 아는 방식으로 짓지 말 것)
• 클래스 이름은 명사나 명사구. 메서드 이름은 동사나 동사구
• 문제 영역(Domain)과 해법 영역을 구분하여 문제 영역보다 해법 영역의 이름을 사용한다.

암기는 도구에게 맡기고, 우리는 문장이나 문단처럼 읽히는 코드, 아니면 적어도 표나 자료구조처럼 읽히는 코드를 짜는데만 집중하자.

오늘 읽은 소감은? 떠오르는 생각을 가볍게 적어보세요.

얼마 전에 생년월일에 대한 변수명을 birth_yyyymmdd로 설정한 것을 보았다. 당연히 8자리 값일 줄 알고 코드를 짰다가 실은 그게 6자리 값인 걸 알고 다시 수정해야 했던 적이 있다. 이렇게 극단적인 경우는 드물겠지만 의도를 명확히 드러낼 수 있는 변수명은 굉장히 중요하다는 것을 다시 한번 확인한다.

궁금한 내용이 있거나, 잘 이해되지 않는 내용이 있다면 적어보세요.

API 응답값을 가져올 때 응답값 변수명을 response로 정하는 경우가 많다. 의미를 명확히 하기 위해 가령 날씨 정보라고 한다면 weatherInfo라고 변수명을 정하는 것이 낫지 않을까?