[Good Code, Bad Code] 가독성이 높은 코드를 작성하라(마무리) /예측 가능한 코드를 작성하라 -1
·
📚 개발자의 서재/Good Code, Bad Code
해당 포스팅은 톰 롱의 Good Code, Bad Code (P.157~168)를 읽고 정리한 글입니다. 프로그래밍 언어의 새로운 기능을 적절히 사용하라프로그래밍 언어의 새로운 기능은 개발자들이 신중하게 고민한 결과물이므로, 이를 적극 활용하면 코드의 가독성과 견고성을 높일 수 있다. 따라서 새로운 기능이 생겼을 때, 해당 기능을 어떻게 적용할 수 있을지 고민해봐야 한다. 언어가 제공하는 기능을 사용하면 코드가 최적화되어 효율적이고 버그가 없을 가능성이 커지게 된다. 그러나 새로운 기능을 맹목적으로 도입하는 것은 바람직하지 않다. 기능의 이점이 명확하더라도, 유지보수 측면에서 팀원들이 이를 충분히 이해하고 있는지 고려해야 한다. 또한, 해당 기능이 문제 해결에 적합한지 신중히 판단해야 한다.가독성을 높이..
[Good Code Bad Code] 가독성 높은 코드를 작성하라-3
·
📚 개발자의 서재/Good Code, Bad Code
해당 포스팅은 톰 롱의 Good Code, Bad Code (P.146~157)를 읽고 정리한 글입니다. 설정되지 않은 값을 사용하지 말라하드 코드로 작성될 값이 필요한 경우가 존재한다. 예를 들어 단위 변환이나 계산식에 필요한 계수, 작업 재시도 최대 횟수와 같은 조정 가능한 파라미터 값 그리고 템플릿을 나타내는 문자열 등이 있다. 처음 보는 개발자는 그 의미를 쉽게 이해하기 어렵다. 코드에 설명되지 않은 값이 포함되면 혼란을 초래하고, 이는 버그로 이어질 수 있다. 따라서 해당 값이 의미하는 바를 다른 개발자들이 명확하게 이해할 수 있도록 해야 한다. 이를 위한 방법은 다음과 같다.잘 명명된 상수를 사용하라잘 명명된 함수를 사용하라 (상수를 반환하는 공급자 함수 / 변환을 수행하는 헬퍼 함수)상수나 ..
가독성 높은 코드를 작성하라-2
·
📚 개발자의 서재/Good Code, Bad Code
해당 포스팅은 톰 롱의 Good Code, Bad Code (P.134~146)를 읽고 정리한 글입니다. 일관된 코딩 스타일을 고수하라잘 읽히는 문장을 쓰기 위해 따라야 할 문체에 관한 지침들도 있다. 코드도 마찬가지다. 일관적이지 않은 코딩 스타일은 혼동을 일으킬 수 있다.예를 들어 클래스 이름은 일반적으로 첫 글자를 대문자로 작성되는 반면 변수 이름은 소문자로 시작한다. 만약 이것을 지키지 않게 된다면 예상치 못한 버그가 발생할 수 있다. 스타일 가이드를 채택하고 따라야 한다일관된 코딩 스타일을 가지게 된다면 가독성이 좋아지고, 팀 간의 오해가 줄어들고 버그가 사라진다. 코딩 스타일이 다루는 측면명명법언어의 특정 기능 사용코드 들여쓰기패키지 & 디렉터리 구조화코드 문서화 방법 등.린터(linter)스..
가독성 높은 코드를 작성하라-1
·
📚 개발자의 서재/Good Code, Bad Code
해당 포스팅은 톰 롱의 Good Code, Bad Code (P.123~134)를 읽고 정리한 글입니다. 서술형 명칭 사용클래스, 함수, 변수의 이름은 자체적으로 의미를 명확히 전달할 수 있도록 직관적으로 지어야 한다.  서술적이지 않은 이름은 코드의 가독성을 떨어뜨린다. 이를 보완하기 위해 주석이나 문서를 추가할 수 있지만, 완전한 해결책이 되지는 않는다. 반면, 서술적인 이름을 사용하면 코드가 직관적으로 이해하기 쉬워지고, 불필요한 주석이나 문서를 줄여 코드가 더욱 깔끔해진다. 주석문의 적절한 사용클래스와 같이 큰 단위의 코드가 무엇을 하는지 요약하는 높은 수준에서의 주석문은 유용하다. 그러나 하위 수준에서 한 줄 한 줄 코드가 무엇을 하는지 설명하는 주석문은 가독성을 높이기 위한 효과적인 방법이 아..