[BOOK REVIEW] CLEAN CODE - Chapter 02

Nomad Book Club Challenge - DAY 3 (2022.02.20)

:book: 오늘 읽은 범위 : 2장 의미있는 이름


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

  • 의도를 분명히 밝혀라
    • 변수나 함수 그리고 클래스 이름은 다음 질문에 답해야 한다.
      • 존재 이유? 수행 기능? 사용 방법?
    • 단순히 이름만 고쳐도 함수가 하는 일을 이해하기 쉬워졌다.
  • 그릇된 정보를 피하라
    • 실제 List가 아니라면, accountList라 명명하지 않는다.
  • 의미있게 구분하라
    • Info나 Data는 a, the와 마찬가지로 의미가 불분명한 용어다.
  • 검색하기 쉬운 이름을 사용하라
    • 이름을 의미있게 지으면 이름이 길어진다.
    • 검색이 쉽다는 관점에서는 긴 이름이 짧은 이름보다 좋다.
  • 클래스 이름
    • Manager, Processor, Data, Info 등과 같은 단어는 피하자.
  • 불필요한 맥락을 없애라
    • 의미가 분명한 경우에는 짧은 이름이 긴 이름보다 좋다.

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

  • 바로 지난주에도 회사에서 클래스 이름에 대해 한참 고민했다. 클래스의 용도를 분명하게 하려고 이름을 좀 길게 지었는데 너무 긴 건 아닌지 마음에 걸렸다. 의미있는 이름은 길어지는 것이 당연하고 검색이 용이하다는 장점이 있다는 설명을 보니 누가 클래스 이름에 대해 물어봐도 잘 설명할 수 있을 것 같아서 뿌듯하다.
  • 고민하고 있던 네이밍에 대한 챕터라서 더욱 유용했고 책을 읽으면서 내가 작성한 코드에 대한 근거가 탄탄해져서 자신감이 생긴다.

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

  • Info, Data는 DTO 이름으로 자주 사용했는데 DTO에 사용하는 것도 좋지 않은 네이밍인지 확실히 모르겠다.

:sunglasses: TAGS #코딩 #개발자 #노마드북클럽 #노개북

Leave a comment