[CleanCode] 5. 형식 맞추기

[CleanCode] 5. 형식 맞추기

적절한 행 길이를 유지하라

• 자바 소스 파일의 크기 200줄 미만!

• 신문 기사처럼 작성하라
  • 소스 파일의 첫 부분: 고차원 개념 & 알고리즘
  • 소스 파일의 마지막 부분: 저차원 함수와 세부 내역

• 개념은 빈 행으로 분리하라
  • 패키지 선언부, import 문, 각 함수 사이에 빈 행

• 세로 밀집도
  • 서로 밀접한 코드 행은 가까이 둔다
  • 서로 밀접한 개념은 한 파일에 속한다
  • 변수 선언:
    • 사용하는 위치에 최대한 가까이 선언
    • 짧은 지역 변수에서는 각 함수 맨 처음에 선언
  • 인스턴스 변수:
    • 클래스 맨 처음에 선언
    • 변수 간 빈 행 X
  • 종속 함수(한 함수가 다른 함수를 호출하는 경우):
    • 두 함수 세로로 가까이 배치
    • 호출하는 함수를 호출되는 함수보다 먼저 배치
  • 개념적 유사성:
    • 비슷한 동작을 수행하는 함수들 세로로 가까이 배치
• 세로 순서
  • 일반적으로 함수 호출 종속성 아래 방향으로 유지
  • 가장 중요한 개념을 가장 먼저 배치

가로 형식 맞추기

• 짧은 행이 바람직, 120자 이상 X

• 들여쓰기
  • 간단한 if문, 짧은 while문, 짧은 함수
    -> 들여쓰기를 무시하고 싶어도, 무시하지 않는다
    (블록을 감싸는 중괄호는 생략 가능)

팀 규칙

• 모든 팀원은 각자 선호하는 규칙이 있더라도, 팀 규칙을 따라야 한다