[클린코드][2장] - 의미있는 이름

안녕하세요 Dibrary입니다.

클린코드를 읽고 계속 생각할 내용을 정리 해 두고자 합니다.

코드를 작성하면서 문득 '코드를 더 클린하게 할 방법이 없을까' 하고 떠오를 때마다 참고할 생각입니다.

 

---

1. 변수, 함수의 의도를 분명하게 밝히자.

 

2. 일관성이 떨어지는 표기법은 피하자.

 

3. 널리 쓰이는 단어를 다른 의미로 사용하지 말자.

 

4. 이름이 달라진다면 의미도 달라져야 한다.

 

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

검색을 할 때 특정 단어를 검색하면 관련 함수만 몇 개 서칭결과로 나와야 찾기가 용이합니다.
모든 함수마다 단어를 공통으로 사용했다면, 서칭결과가 매우 많이 나오겠죠?

 

6. 인터페이스 이름에 접두어 붙이지 말기.

굳이 차이를 주겠다면 "클래스이름 + Impl" 로 붙이는걸 추천합니다.

클래스 이름은 명사나 명사구가 적합하다.
메서드 이름은 동사나 동사구가 적합하다.

 

7. 한 개념에 한 단어를 쓰자.

 

8. 일반적으로 의미가 분명한 경우에 짧은 이름이 긴 이름보다 좋다.