Community

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

← Go back
TIL 2장 의미있는 이름
#clean_code
2년 전
474


TIL (Today I Learned)

2022.02.20

오늘 읽은 범위

2장. 의미있는 이름

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

<이름 잘 짓는 간단한 규칙 몇 가지>

  • 의도를 분명히 밝혀라

  • 그릇된 정보를 피하라

    : 그릇된 단서는 코드 의미를 흐린다. 나름대로 널리 쓰이는 의미가 있는 단어를 다른 의미로 사용해도 안 된다. (24p)

  • 의미 있게 구분하라

    : 불용어는 중복이다. 변수 이름에 variable이라는 단어는 단연코 금물이다. 표 이름에 table이라는 단어도 마찬가지다. (26p)

  • 발음하기 쉬운 이름을 사용하라

: 발음하기 쉬운 이름을 선택한다. 발음하기 어려운 이름은 토론하기도 어렵다. (p27)

  • 검색하기 쉬운 이름을 사용하라

  • 인코딩을 피하라

  • 자신의 기억력을 자랑하지 마라

  • 기발한 이름은 피하라

: 특정 문화에서만 사용하는 농담은 피하는 편이 좋다. 의도를 분명하고 솔직하게 표현하라.

  • 한 개념에 한 단어를 사용하라

  • 말 장난을 하지 마라

  • 해법 영역에서 가져온 이름을 사용하라

: 코드를 읽을 사람도 프로그래머라는 사실을 명심한다. (34p)

  • 의미 있는 맥락을 추가하라

  • 불필요한 맥락을 없애라

<주의>

  • 사람들이 이름을 바꾸지 않으려는 이유 하나는 다른 개발자가 반대할까 두려워서다. 우리들 생각은 다르다. 오히려 반갑고 고맙다. 우리들 대다수는 자신이 짠 클래스 이름과 메서드 이름을 모두 암기하지 못한다. (38p)

  • 여느 코드 개선 노력과 마찬가지로 이름 역시 나름대로 바꿨다가는 누군가 질책할지도 모른다. 그렇다고 코드를 개선하려는 노력을 중단해서는 안 된다. (38p)

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

  • 의미 있는 이름 정하기는 막연하게 깔끔하고 간결하고 의미 전달만 가능하게 적는 것 아닌가? 라고 생각했던 나에게 더 주의 깊게 생각해야 할 부분이 많다는 것을 알려준 챕터였다.

  • 실제로 코드를 작성할 때 이름 정하기가 너무나 어려웠는데 참고하면 좋을 챕터!

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