tl:dr
코드 형식은 단순히 스타일의 문제가 아니라 커뮤니케이션의 문제이다.
기억하고싶은 내용과 궁금증 및 견해
주요 내용들을 정리하자면 다음과 같다.
수직 형식 (Vertical Formatting)
•
파일 크기: 작은 파일이 이해하기 쉬움 (200~500줄 정도가 적당)
•
신문 기사처럼: 위에서 아래로 읽을 때 고수준 개념이 먼저, 세부사항은 아래로
•
수직 거리: 관련된 개념은 가까이, 관련 없는 개념은 멀리 배치
◦
변수는 사용하는 위치에 최대한 가까이 선언
◦
인스턴스 변수는 클래스 맨 처음에 선언
◦
종속 함수는 호출하는 함수 바로 아래 배치
수평 형식 (Horizontal Formatting)
•
행 길이: 120자 이하 권장
•
가로 공백: 연산자 주변, 함수 이름과 괄호 사이 등에 공백으로 의미 강조
팀 규칙
•
팀 전체가 일관된 형식 규칙을 따르는 것이 개인 취향보다 중요
챕터의 마지막 부분에 로버트 C마틴은 이렇게 말한다.
좋은 소프트웨어 시스템은 읽기 쉬운 문서로 이뤄진다는 사실을 기억하길 바란다.
결국 코드는 문서다. 우리가 작성하는 소프트웨어는 읽히기 위해 존재한다. 일관된 형식은 단순한 미학이 아니라, 동료개발자에게 이 코드는 신뢰할 수 있다는 메시지를 전달하는 약속이라고 생각한다. 파일마다 들여쓰기 , 네이밍 컨벤션 등 prettier, eslint툴을 이용해 팀과 마주 앉아 구현 스타일을 논의하는 것 또한 선택이 아닌 필수지 않을까?