[Book]Clean Code 5장

  • 적절한 행 길이를 유지하라
    • 200줄 정도인 파일로도 커다란 시스템을 구축할 수 있다.
  • 신문 기사처럼 작성하라
    • 이름은 간단하면서도 설명이 가능하게 짓는다.
    • 이름만 보고도 올바른 모듈을 살펴보고 있는지 아닌지를 판단할 정도로 신경써서 짓는다.
    • 소스 파일 첫 부분은 고차원 개념과 알고리즘을 설명한다.
    • 아래로 내려갈수록 의도를 세세하게 묘사한다.
    • 마지막에는 가장 저차원 함수와 세부내역이 나온다.
  • 개념은 빈 행으로 분리하라
  • 세로 밀집도 : 서로 밀접한 코드 행은 세로로 가까이 놓여야 한다
  • 수직 거리 : 같은 파일에 속할 정도로 밀접한 두 개념은 세로 거리로 연관성을 표현한다.
    • 변수 선언 : 변수는 사용하는 위치에 최대한 가깝게 선언
    • 인스턴스 변수 : 인스턴스 변수는 클래스 맨 처음에 선언한다. 변수 간에 세로로 거리를 두지 않는다.
    • 종속 함수 : 한 함수가 다른 함수를 호출한다면, 두 함수는 세로로 가까이 배치한다. 호출하는 함수를 호출되는 함수보다 먼저 배치한다.
  • 개념적 유사성 : 친화도가 높을수록 코드를 가까이 배치한다.
    • 한 함수가 다른 함수를 호출해 생기는 종속성
    • 변수와 그 변수를 사용하는 함수
    • 비슷한 동작을 수행하는 일군의 함수
  • 가로 형식 맞추기
    • 짧은 행이 바람직하다. (최대 120자 정도로 행 길이를 제한하자. 보통 80~100자)
  • 가로 공백과 밀집도
  • 가로 정렬은 비추천
  • 들여쓰기
  • 가짜 범위 : 빈 while문이나 빈 for문은 새 행에 ;을 제대로 들여써서 넣어준다.
  • 팀 규칙 : 스타일은 일관적이고 매끄러워야 한다. 한 소스파일에서 봤던 형식이 다른 소스 파일에도 쓰이리라는 신뢰감을 독자에게 줘야 한다.

카테고리:

업데이트:

댓글남기기