Clean Code 1장. 깨끗한 코드

HYl·2022년 4월 23일
0

Clean Code

목록 보기
1/9

DAY 1

  • 오늘 읽은 범위 : 시작 ~ 1장, 깨끗한 코드

책에서 기억하고 싶은 내용을 써보세요.

나쁜 코드

우리 모두는 자신이 짠 쓰레기 코드를 쳐다보며 나중에 손보겠다고 생각한 경험이 있다. 우리 모두는 대충 짠 프로그램이 돌아간다는 사실에 안도감을 느끼며 그래도 안 돌아가는 프로그램보다 돌아가는 쓰레기가 좋다고 스스로를 위로한 경험이 있다. 다시 돌아와 나중에 정리하겠다고 다짐했었다. 물론 그때 그 시절 우리는 르블랑의 법칙을 몰랐다. 나중은 결코 오지 않는다.

태도

“아니, 잠깐만요! 상사가 시키는 대로 하지 않으면 짤린다구요!” 글쎄다. 겉으로 아닌 듯 행동해도 대다수 관리자는 진실을 원한다. 일정에 쫓기더라도 대다수 관리자는 좋은 코드를 원한다. 그들이 일정과 요구사항을 강력하게 밀어붙이 는 이유는 그것이 그들의 책임이기 때문이다. 좋은 코드를 사수하는 일은 바로 우리 프로그래머들의 책임이다.

원초적 난제

진짜 전문가는 두 번째 부분이 틀렸다는 사실을 잘 안다. 나쁜 코드를 양산하면 기한을 맞추지 못한다. 오히려 엉망진창인 상태로 인해 속도가 곧바로 늦어 지고, 결국 기한을 놓친다. 기한을 맞추는 유일한 방법은, 그러니까 빨리 가는 유일한 방법은, 언제나 코드를 최대한 깨끗하게 유지하는 습관이다.

환자는 상사다.

1847년에 이그너츠 세멀바이스(Ignaz Semmelweis)가 의사들에게 손을 씻으라고 권장했을 때 의사들은 환자를 보느라 너무 바쁘므로 환자 방문 사이에 손 씻을 시간이 없다는 이유로 거부했다.

깨끗한 코드란?

  • 중복을 피하라. 한 기능만 수행하라. 제대로 표현하라. 작게 추상화하라.

비야네 스트롭스트룹 : C++ 창시자이자 The C++ Programming Language6 저자

나는 우아하고 효율적인 코드를 좋아한다. 논리가 간단해야 버그가 숨어들지 못한다. 의존성을 최대한 줄여야 유지보수가 쉬워진다. 오류는 명백한 전략에 의거해 철저히 처리한다. 성능을 최적으로 유지해야 사람들이 원칙 없는 최적화로 코드를 망치려는 유혹에 빠지지 않는다. 깨끗한 코드는 한 가지를 제대로 한다.

  • 깨끗한 코드는 세세한 사항까지 꼼꼼하게 처리하는 코드다 (오류 처리, 메모리 누수, 경쟁 상태, 일관성 없는 명명법)
  • 깨끗한 코드는 한 가지에 집중한다. 각 함수와 클래스와 모듈은 주변 상황에 현혹되거나 오염되지 않은 채 한길만 걷는다.

그래디 부치 : Object Oriented Analysis and Design with Application 저자

깨끗한 코드는 단순하고 직접적이다. 깨끗한 코드는 잘 쓴 문장처럼 읽힌다. 깨끗한 코드는 결코 설계자의 의도를 숨기지 않는다. 오히려 명쾌한 추상화와 단순한 제어문으로 가득하다.

  • 가독성을 강조한다.
  • 코드는 추측이 아니라 사실에 기반해야 한다.

큰 데이브 토마스 : OTI 창립자이자 이클립스 전략의 대부

깨끗한 코드는 작성자가 아닌 사람도 읽기 쉽고 고치기 쉽다. 단위 테스트 케이스와 인수 테스트 케이스가 존재한다. 깨끗한 코드에는 의미 있는 이름이 붙는다. 특정 목적을 달성하는 방법은 (여러 가지가 아니라) 하나만 제공한다. 의존성은 최소이며 각 의존성을 명확히 정의한다. API는 명확하며 최소로 줄였다. 언어에 따라 필요한 모든 정보를 코드만으로 명확히 표현할 수 없기에 코드는 문학적으로 표현해야 마땅하다.

  • 깨끗한 코드란 다른 사람이 고치기 쉽다고 단언한다. (실제로 읽기 쉬운 코드와 고치기 쉬운 코드는 엄연히 다르다)
  • 깨끗한 코드를 테이트 케이스와 연관짓는다.
  • 큰 코드보다 작은 코드에 가치를 둔다.
  • 인간이 읽기 좋은 코드를 작성하라,

마이클 페더스 : Working Effectively with Legacy Code 저자

깨끗한 코드의 특징은 많지만 그 중에서도 모두를 아우르는 특징이 하나 있다. 깨끗한 코드는 언제나 누군가 주의 깊게 짰다는 느낌을 준다. 고치려고 살펴봐도 딱히 손 댈 곳이 없다. 작성자가 이미 모든 사항을 고려했으므로. 고칠 궁리를 하다보면 언제나 제자리로 돌아온다. 그리고는 누군가 남겨준 코드, 누군가 주의 깊게 짜놓은 작품에 감사를 느낀다.

  • 깨끗한 코드는 주의 깊게 작성한 코드다.
  • 누군가 시간을 들여 깔끔하고 단정하게 정리한 코드다.

론 제프리스 : Extreme Programming Installed9와 Extreme Programming Adventure in C# 저자

최근 들어 나는 켄트 벡이 제안한 단순한 코드 규칙으로 구현을 시작한다. (그 리고 같은 규칙으로 구현을 거의 끝낸다.) 중요한 순으로 나열하자면 간단한 코드는

  • 모든 테스트를 통과한다.
  • 중복이 없다
  • 시스템 내 모든 설계 아이디어를 표현한다
  • 클래스, 메서드, 함수 등을 최대한 줄인다

보이스카우트 규칙

잘 짠 코드가 전부는 아니다. 시간이 지나도 언제나 깨끗하게 유지해야 한다. 시간이 지나면서 엉망으로 전락하는 코드가 한둘이 아니다. 그러므로 우리는 적극적으로 코드의 퇴보를 막아야 한다.

캠프장은 처음 왔을 때보다 더 깨끗하게 해놓고 떠나라

한꺼번에 많은 시간과 노력을 투자해 코드를 정리할 필요가 없다. 변수 이름 하나를 개선하고, 조금 긴 함수 하나를 분할하고, 약간의 중복을 제거하고, 복잡한 if 문 하나를 정리하면 충분하다.

지속적인 개선이야말로 전문가 정신의 본질이 아니던가?


오늘 읽은 소감은?

개발을 할 때 항상 변수명을 기능에 알맞게 작성하는 것에 귀찮아하는 경향이 있었는데, 이 글을 읽는 동안 내가 그동안 변수명 작성에 대하여 무심 하였던 것이 추후에 유지보수를 하게 될 개발자에게 민폐가 되는 행동이었음을 깨닫고 반성하였다.

르블랑의 법칙을 항상 기억하자, 나중은 오지 않는다.

profile
꾸준히 새로운 것을 알아가는 것을 좋아합니다.

0개의 댓글