[Good Code Bad Code] 가독성 높은 코드를 작성하라-3

해당 포스팅은 톰 롱의 Good Code, Bad Code (P.146~157)를 읽고 정리한 글입니다.

 

설정되지 않은 값을 사용하지 말라

하드 코드로 작성될 값이 필요한 경우가 존재한다. 예를 들어 단위 변환이나 계산식에 필요한 계수, 작업 재시도 최대 횟수와 같은 조정 가능한 파라미터 값 그리고 템플릿을 나타내는 문자열 등이 있다.

 

처음 보는 개발자는 그 의미를 쉽게 이해하기 어렵다. 코드에 설명되지 않은 값이 포함되면 혼란을 초래하고, 이는 버그로 이어질 수 있다. 따라서 해당 값이 의미하는 바를 다른 개발자들이 명확하게 이해할 수 있도록 해야 한다. 이를 위한 방법은 다음과 같다.

• 잘 명명된 상수를 사용하라
• 잘 명명된 함수를 사용하라 (상수를 반환하는 공급자 함수 / 변환을 수행하는 헬퍼 함수)

상수나 함수를 사용하여 값을 표현하거나 처리하면 가독성을 높이면서도 추가 작업이 거의 필요하지 않다. 함수를 사용할 경우 재사용성을 고려할 가치가 있으며, 재사용이 필요하다면 유틸리티 클래스에 포함하는 것이 좋다.

---

익명 함수를 적절히 사용하라

익명 함수는 간단한 로직에 적합하지만, 명명 함수와 달리 함수명으로 정보를 제공하지 않기 때문에 가독성을 해칠 수 있다. 명명 함수를 정의하려면 반복적인 코드가 많아질 수 있으나, 익명 함수의 내용이 한눈에 들어오지 않는다면 오히려 가독성이 저하된다. 따라서 구현 세부 사항은 명명 함수로 분리하는 것이 좋다.

 

익명 함수가 너무 길면 가독성이 떨어지므로, 여러 개의 명명 함수로 나누는 것이 재사용성과 가독성 측면에서 더욱 효과적이다.