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

이호석·2022년 2월 21일
0

클린코드

목록 보기
3/9

챕터 2. 의미 있는 이름

의도를 분명히 밝혀라

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

복잡하고 프로젝트일수록 함수의 이름을 간단 명료하게 작성하는 것은 어려운 일이지만, 힘들다고 피한다면 나중에 함수의 이름을 봐도 쉽게 기억해내지 못하고 코드의 전부를 봐야 이해할 것이다.

클래스 이름과 메소드 이름

  • 클래스 이름과 객체 이름은 명사나 명사구가 적합하다. Customer, Account, AddressParser...
  • 메소드 이름은 동사나 동사구가 적합하다. postPayment, deletePage, save... 접근자, 변경자, 조건자는 값 앞에 get, set, is를 붙인다.

간단하면서도 쉬운 규칙이지만 처음에 습관을 들이지 않는다면 피곤할 수 있는 규칙이다.

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

추상적인 개념 하나에 단어 하나를 선택해 이를 고수한다.

팀 단위로 일을 한다면 반드시 지켜야할 규칙이다. 예를 들어, add메소드는 값을 수학적으로 더하는 메소드라고 가정하자. 이어서 새롭게 작성하는 메소드는 집합 또는 컬렉션에 값을 하나 추가한다. 이 메소드의 이름에 add가 들어가도 괜찮을까? 맥락이 다르므로 이때에는 insert나 append라는 이름이 적당하다.

2강 후기

좋은 이름을 선택하려면 설명하는 능력이 뛰어나야 하고 문화적인 배경이 같아야 한다.

흔히 우스갯소리로 개발자한테 가장 어려운 것 중 하나가 이름 짓는 것이라 한다. 전에는 괜찮은 이름이 떠오르지 않아서 생산적이지 않은 일이라 생각했던것이 이 챕터를 읽으면서 중요한 부분이라는 것을 깨닫게 됐다. 단순히 내가 새로운 코드를 본다고 가정했을때, 이름이 중복되거나 코드와 동떨어진 이름의 변수나 함수 보다, 명확하고 간단한 이름으로 짜여진 코드를 보는게 이해가 더 빠르다는 것을 부정할 수 없다.

0개의 댓글