누가봐도 인생 1회차의 기록장

개발공부/JavaScript 책

[클린코드] TIL (2. 의미있는 이름)

김놀먹 2022. 4. 24. 20:36

오늘 TIL 요약

  • 문장이나 문단처럼 읽히는 코드 아니면 적어도 표나 자료 구조처럼 읽히는 코드를 짜는 데 집중하자

 

책에서 기억하고 싶은 내용

  • 의도를 분명히 밝혀라 -변수(혹은 함수나 클래스)의 존재 이유, 수행 기능, 사용 방법 그외 주석이 필요하다면 의도를 분명히 드러내지 못한 것 => 문제는 코드의 단축성이 아니라 함축성
  • 그릇된 정보를 피하라 - 일관성이 떨어지는 정보는 그릇된 정보
  • 의미 있게 구분하라
  • 발음하기 쉬운 이름을 사용하라
  • 검색하기 쉬운 이름을 사용하라 (ex. 7, e 조심)
  • 인코딩을 피하라
  • 자신의 기억력을 자랑하지 마라 (루프에서 반복 횟수를 세는 변수를 쓸 때 'l'은 절대 안됨!)
  • 기발한 이름은 피하라
  • 한 개념에 한 단어를 사용하라
  • 말장난을 하지 마라
  • 해법 영역, 문제 영역에서 가져온 이름을 사용하라 (?)
  • 의미 있는 맥락을 추가하고 불필요한 맥락을 없애라
  • 클래스, 객체 이름 => 명사, 명사구
  • 메서드 이름 => 동사, 동사구

 

오늘 읽은 소감은? 

긴 이름이 짧은 이름보다 좋다는데 나는 아직 개인적으로 짧은 이름이 더 이해하기 쉬운 것 같다. 어떤게 좋은지 많이 써보면서 고민해봐야 할 듯

 

궁금한 내용, 잘 이해되지 않는 내용

  • 불용어 noise word
  • 해법영역? 문제 영역?