노마드코더 개발자북클럽 Clean code TIL 2 : 2장. 의미 있는 이름
오늘 TIL 3줄 요약
의도가 분명한 이름
명료하고 맥락에 맞는 일관성
'코드 감각'을 기르려면
디자인 패턴같은 이론만으로는 부족하고
실천해야한다.
TIL (Today I Learned) 날짜
2025. 05. 25
오늘 읽은 범위
2장. 의미 있는 이름
기억하고 싶은 내용을 써보세요.
따로 주석이 필요하다면
이름에 의도를 분명히 드러내지 못한 것코드의 단순성이 아니라 코드의 함축성이 좋아야함.
약어와 같은 그릇된 단서를 남기지 마라.
일관성이 떨어지는 표기법 = 그릇된 정보.
불용어를 피하라.
다만 a, the를 사용한 지역변수의 구분은
최신 IDE에서 필요가 없어짐.읽는 사람이 차이를 알도록 이름을 짓기
발음하기 쉬운 이름 사용하기.
지적인 대화를 위해..
프로그래밍은 사회 활동이다 !검색하기 쉬운 이름을 사용하기
접두어는 구닥다리
작가는 Abstract Factory 구현을 위한 인터페이스 클래스도
Interface를 의미하는 I 접두어를 피하는 편이 좋다고 생각한다.명료함이 최고
의미가 분명하다는 조건 하에
짧은 이름이 긴 이름보다 좋다.불필요한 맥락을 없애고
의미 있는 맥락을 추가하자기술 개념엔 기술 이름을 쓰고
문제 영역에서는 문제 영역의 이름을 쓰자.한 개념에 한 단어를 사용하여
어휘의 일관성을 높이자.
Controller/ Manager
fetch/retrieve/get
단, 같은 맥락일 때만.
오늘 읽은 소감은? 떠오르는 생각을 가볍게 적어보세요
전부 공감함 !
마지막 Controller/Manger 예시의 경우
실제 내가 못생긴 코드를 짠 기억이 있어서 매우 뼈아프다.
궁금한 내용이 있거나, 잘 이해되지 않는 내용이 있다면 적어보세요.
- Visitor 패턴은 뭘까?
- FastAPI 프로젝트에서 repository패턴을 쓰고 있는데
이 패턴의 개념과 장단점을 알고 싶다.
오늘 읽은 다른사람의 TIL
댓글
댓글 쓰기