클린코드(Clean Code). 의미 있는 이름짓기2

✨ 기발한 이름은 피하라

기발하고 재미난 이름보다 명료한 이름을 선택하라

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

 

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

메서드 이름은 독자적이고 일관적이어야 한다

그래야 주석을 뒤져보지 않고도 프로그래머가 올바른 메서드를 선택한다

고로 일관성 있는 어휘는 코드를 사용할 프로그래머가 반갑게 여길 선물이다

 

✨ 말장난을 하지 마라

한 단어를 두가지 목적으로 사용하지 마라

지금까지 구현한 add 메서드는 모두가 기존 값 두 개를 더하거나 이어서 새로운 값을 만든다고 가정하자 새로 작성하는 메서드는 집합에 값 하나를 추가한다고 하면 일관성을 지키기 위해 add라고 불러야하나? 하지만 이 새 메서드는 기존 add 메서드와 맥락이 다르기에 add라 부른다면 이는 말장난이나 마찬가지다

 

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

기술 개념에는 기술 이름이 가장 적합한 선택이다

 

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

적절한 프로그래머 용어가 없다면 문제 영역에서 이름을 가져온다

 

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

클래스, 함수, 이름 공간에 넣어 맥락을 부여한다
모든 방법이 실패하면 마지막 수단으로 접두어를 붙인다

 

✨ 불필요한 맥락을 없애라

의미가 분명한 경우에 한해서 짧은 이름이 긴 이름보다 좋다
이름에 불필요한 맥락을 추가하지 않도록 주의한다