Community

개발자 99% 커뮤니티에서 수다 떨어요!

← Go back
TIL/클린코드 2장 의미 있는 이름
#clean_code
2년 전
836


TIL (Today I Learned)

2022.02.20

오늘 읽은 범위

2장. 의미 있는 이름

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

  • 의도를 분명히 밝혀라(22P)

- 따로 주석이 필요하다면 의도를 분명히 드러내지 못했다는 말이다.

  • 그릇된 정보를 피하라(24p)

- 실제 리스트가 아니라면 accountList로 명명하지 않는다. 그릇된 정보를 제공하는 셈

- 일관성이 떨어지는 표기법은 그릇된 정보(25p)

  • 의미있게 구분하라(25p)

- Customer라는 클래스와 CustomerObj 클래스의 차이를 알겠는가?

: 해당 차이가 무엇인지 구별할 수 있도록 변수명을 지어라

  • 발음하기 쉬운 이름을 사용하라(27p)

  • 검색하기 쉬운 이름을 사용하라(28p)

- 숫자 7은 검색하기 어렵다.

  • 인코딩을 피하라(29p)

  • 자신의 기억력을 자랑하지 마라(31p)

  • 클래스 이름: 명사나 명사구가 적합하다(Customer, Account...)

  • 메서드 이름: 동사나 동사구가 적합하다(postPayment...)

  • 말장난을 하지마라

- 한 단어를 두가지 목적으로 사용하지 마라(34p)

  • 문제 영역에서 가져온 이름을 사용하라(34p)

  • 의미 있는 맥락을 추가하라(35p)

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

  • 정말 간단해 보이면서도 어려운 것이 변수명 짓기가 아닐까 싶다. 변수명을 잘못 지으면 당장에 오류가 나지는 않지만, 잘못 지은 댓가는 나중에 치르기 때문이지 않을까 싶다.

  • param1, param2, rightLeftbotton, < 실제로 본 변수명들이다. 신입시절 이렇게 변수명을 지어서 한동안 놀림받은 동기가 있었는데 사실 티가 안 나서 그렇지 책을 읽어보면서 나도 비슷한 실수를 했었을지도 모른다고 생각하니 조금은 부끄러워졌다.

  • 사실 이 책을 읽고도 변수명을 어떻게 지어야겠다! 라고만 생각이 들지 정작 코딩할 때가 되면 신경을 세심하게 안 쓰게 되는게 변수명 짓기인 것 같다. 이 목록들은 메모장에 적어두고 두고두고 봐야 할 것 같다.

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