목록 보기
코드 품질 개선 기법 15편: 문법은 이름을 나타낸다
기타

코드 품질 개선 기법 15편: 문법은 이름을 나타낸다

라인
라인
2025년 6월 11일

두줄요약

이름은 선언 측의 일관성보다 사용하는 측의 오해 가능성을 줄이는 방향이 중요하다고 설명했습니다. 수식어를 앞에 두는 명명과 언어·플랫폼의 표준 규칙을 따르는 예를 제시했습니다.

핵심 내용

  • 클래스나 변수 이름은 선언 측의 보기 좋은 일관성보다 사용하는 측의 오해 가능성 최소화가 우선
  • AccountSettingRepository처럼 수식어를 앞에 두면 문법적으로 자연스럽고 의미 해석이 쉬움
  • 수식어가 여러 개면 전치사로 마지막 수식어구를 분리해 의미 충돌을 줄일 수 있음
  • 타입 이름에서는 전치사 기반의 후위 수식보다 표준 명명 규칙과 언어 관례를 따르는 편이 적절

적용해볼 점

  • 이름을 지을 때 읽는 사람 입장에서 먼저 해석해 보기
  • 공통 접미사보다 역할을 앞에 드러내는 명명 검토
  • 언어와 플랫폼의 기존 API 명명 방식과의 정합성 확인

댓글 0

댓글을 작성하려면 로그인이 필요합니다.

댓글을 불러오는 중...