
기타
코드 품질 개선 기법 15편: 문법은 이름을 나타낸다
두줄요약
이름은 선언 측의 일관성보다 사용하는 측의 오해 가능성을 줄이는 방향이 중요하다고 설명했습니다. 수식어를 앞에 두는 명명과 언어·플랫폼의 표준 규칙을 따르는 예를 제시했습니다.
핵심 내용
- 클래스나 변수 이름은 선언 측의 보기 좋은 일관성보다 사용하는 측의 오해 가능성 최소화가 우선
AccountSettingRepository처럼 수식어를 앞에 두면 문법적으로 자연스럽고 의미 해석이 쉬움- 수식어가 여러 개면 전치사로 마지막 수식어구를 분리해 의미 충돌을 줄일 수 있음
- 타입 이름에서는 전치사 기반의 후위 수식보다 표준 명명 규칙과 언어 관례를 따르는 편이 적절
적용해볼 점
- 이름을 지을 때 읽는 사람 입장에서 먼저 해석해 보기
- 공통 접미사보다 역할을 앞에 드러내는 명명 검토
- 언어와 플랫폼의 기존 API 명명 방식과의 정합성 확인