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

OhJuYeong·2025년 3월 30일

Clean Code

목록 보기
2/15
post-thumbnail

이번장에서는 의미 있는 이름을 강조하는 내용이였다.

그래서 짧게 필요한 내용만 정리해보았다.

📌 의도를 분명하게 밝혀라

의도가 분명한 이름이 정말로 중요하다.

의도가 드러나는 이름을 사용하면 코드 이해와 변경이 쉬워진다.

📌 그릇된 정보를 피하라

코드에 그릇된 단서를 남겨서는 안된다.

나름대로 널리 쓰이는 의미가 있는 단어를 다른 의미로 사용해도 안된다.

유사한 개념은 유사한 표기법을 사용 이것도 정보다.

일관성이 떨어지는 표기법은 그릇된 정보다

📌 의미 있게 구분하라

연속적인 숫자를 덧붙인 이름은 아무런 정보를 제공하지 못하는 이름일뿐이다.

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

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

발은하기 어려운 이름은 토론하기도 어렵다 프로그래밍은 사회활동이기 때문이다.

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

간단한 메서드에서 로컬 변수만 한 문자를 사용 이름 길이는 범위 크기에 비례해야한다.

📌 인코딩을 피하라

해독하기 어려워 진다.

헝가리식 표기법

  • 이제는 헝가리식 표기법이나 기타 인코딩 방식이 오히려 방새가된다. 독자를 오도할 가능성도 커진다.

멤버 변수 접두어

  • 이제는 멤버 변수에 m_ 이라는 접두어를 붙일 필요도 없다.

인터페이스 클래스와 구현 클래스

  • 인코딩이 필요한 경우도 있다
  • 둘중 하나를 인코딩 해야한다면 구현 클래스 이름을 택하겠다.

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

명로함이 최고

📌 클래스 이름

클래스 이름과 객체 이름은 명사나 명사구가 적합하다.

📌 메서드 이름

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

📌 기발한 이름은 피해라

의도를 분명하고 솔직하게 표현하라

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

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

📌 말장난을 하지마라

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

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

스스로 의미가 분명한 이름이 없지않다.

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

📌 불필요한 맥락을 없애라

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


알고 있는 내용이였지만 다시 한번 머릿속에 인지할 수 있는 시간이였다.

profile
기록하는 개발자

0개의 댓글