의미있는 이름(2)

이름 잘 짓기

책너두 5기 4일차

로버트 C. 마틴의 클린코드 p.24 ~ p.34

내용 정리

그릇된 정보를 피하라

이름을 지을 때 비슷한 이름으로 헷갈리게 하거나, 실제 List가 아닌데 list를 넣거나, 소문자l과 대문자 O 등으로 헷갈리게 해선 안된다.

의미 있게 구분하라

다른 이름을 지을 때 명확히 구분되도록 이름을 차별화해라. a1,a2,a3 라던가, customorcustomerobject처럼 어떤 차이인지 모르도록 해선 안된다.

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

팀 프로젝트다보니 대화를 나눠야 하는데 한 글자씩 말해야 하면 불편하다. 읽고 발음할 수 있는 단어를 사용해라.

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

숫자가 섞여있거나 자주 쓰이는 소문자 알파벳이 들어있으면서 짧은 단어는 검색하면 다른 데이터까지 등장한다. 길고 명확하게 지으면 정확하게 검색해서 찾아낼 수 있다.

인코딩을 피하라

예전과 달라져 이름에 타입을 인코딩하거나 접두어를 쓸 필요가 없다.

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

명료함이 최고다. 한글자인 변수 이름을 다 기억할 필요 없이 정확히 적어라.

클래스 이름 : 명사

매서드 이름 : 동사

기발한 이름은 피하라

일부만 알아듣는 이름은 무의미하다

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

똑같은 메서드에 fetch, retrieve, get으로 제각각 부르지 마라. 일관성 있게 어휘를 사용하라.

말장난을 하지 마라

그렇다고해서 같은 맥락이 아닌데 ‘일관성’을 유지하는 것도 곤란하다.

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

읽는 사람도 프로그래머니 수학 용어, 알고리즘 이름 등을 사용해도 좋다.

문제 영역에서 가져온 이름을 사용하라.

적절한 용어가 없으면 문제 영역에서 가져와라.

책을 읽고

계속해서 명명법에 대한 이야기가 나온다. 모두 같은 이야기를 하고있는데,

읽는 사람에게 괜히 부담 주지말고, 한번에 알아볼 수 있게 이름 지어라

#