[Clean Code] 2장 의미 있는 이름

이름을 잘 짓는 규칙

• 의도를 분명히 밝혀라

따로 주석이 필요 없을 정도로 사용 목적이 드러나야 한다.

• 그릇된 정보를 피하라

독단적인 축약를 피하고 서로 흡사한 이름을 사용하지 않는다.

• 의미 있게 구분하라

연속된 숫자를 붙이거나, 불용어를 덧붙이는 건 아무런 정보도 제공하지 않는다.

읽는 사람이 차이를 알도록 이름을 지어라

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

 

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

간단한 메서드에서는 로컬 변수를 한 문자로 사용해도 된다.

이름 길이는 범위에 비례해야 한다.

• 인코딩을 피하라

변수 이름에 타입을 인코딩할 필요 없다.

인터페이스는 접두어를 붙이지 않아도 된다.

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

명료함이 중요하다. 남이 이해하기 쉬운 코드를 내놓아야 한다.

클래스는 명사나 명사구를 사용하고 동사는 사용하지 않는다. 메서드는 동사나 동사구가 적합하다.

• 기발한 이름은 피하라

의도가 분명하고 솔직하게 표현되어야 한다.

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

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

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

다른 개념에 같은 단어를 사용하지 않는다.

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

 

• 불필요한 맥락은 없애라