코드 가독성, 어디까지 파고들어야 할까?

Clean Code는 짧은 메서드를 옹호하지만, 과도한 분해는 얕은 인터페이스와 코드 얽힘을 야기한다. 구체적으로, 작은 메서드는 각 기능의 인터페이스를 단순화하지만, 호출 관계를 파악하기 위해 여러 메서드를 넘나들어야 하는 상황을 만든다. 따라서, 코드 가독성을 해치고, 유지보수성을 저하시킨다는 비판이 제기된다. 반면, 적절한 분해는 관심사 분리를 통해 코드 이해도를 높인다.

Clean Code는 주석을 '표현의 실패'로 간주하지만, APOSD는 적절한 주석의 중요성을 강조한다. 구체적으로, 주석은 코드의 의도를 명확히 하고, 복잡한 로직을 설명하는 데 필수적이다. 따라서, 주석은 개발자 간의 의사소통을 돕고, 코드의 유지보수를 용이하게 한다. 반면, 과도한 주석은 코드 중복을 유발하고, 코드 변경 시 함께 수정해야 하는 부담을 준다.

코드 분해 시 단일 책임 원칙을 따르되, 과도한 분해를 경계해야 한다. 구체적으로, 메서드 간의 의존성을 최소화하고, 코드 얽힘을 방지하기 위해 노력해야 한다. 따라서, 코드의 가독성을 높이고, 유지보수성을 향상시킬 수 있다. 반면, 주석은 코드의 의도를 명확히 전달하는 데 활용하고, 코드 자체로 표현하기 어려운 부분을 보완해야 한다.