※ 본 글은 인사이트에서 출간한 로버트 C. 마틴 저자의 『Clean Code(클린 코드) 애자일 소프트웨어 장인 정신』 책을 읽고 작성하였습니다.

🚦 1장. 깨끗한 코드

🚀 Code

✔ 기계가 실행할 정도로 상세하게 요구사항을 명시하는 작업(프로그래밍)의 결과
✔ 요구사항을 표현하는 언어

• 앞으로 프로그래밍 언어에서 추상화 수준은 점차 높아질 것이며 특정 응용 분야에 적합한 프로그래밍 언어 수도 점차 많아질 것임.
• 고도로 추상화된 언어나 특정 응용 분야 언어로 기술하는 명세 역시 코드이며 어떤 언어를 사용하든 코드는 기계가 이해하고 실행할 정도로 엄밀하고 정확하고 상세하고 정형화되어야 하기 때문에 코드는 사라지지 않을 것임.

🚀 나쁜 코드

✔ 나쁜 코드는 개발 속도를 크게 떨어뜨림.
✔ 코드를 고칠 때마다 엉뚱한 곳에서 문제가 생기고, 매번 얽히고 설킨 코드를 '해독'해서 얽히고 설킨 코드를 더함.
✔ 시간이 지나면서 쓰레기 더미는 점점 높아지고 깊어지고 커지기 때문에 청소할 방법이 없는 불가항력의 존재임.

• 나쁜 코드가 쌓일수록 팀 생산성은 떨어지기 시작해 0으로 근접함.
• 생산성을 증가시키려고 프로젝트에 새 인력을 투입하지만 시스템 설계에 대한 조예가 깊지 않기 때문에 결국은 나쁜 코드를 더 많이 양산하게 되어 생산성은 더더욱 0에 수렴.
• 이로 인해 원대한 재설계의 꿈을 가지고 새로운 타이거 팀이 구성됨.
• 가장 유능하고 똑똑한 사람들만 타이거 팀으로 차출되며 나머지는 계속해서 현재 시스템을 유지보수.
• 그러나 때때로 경주는 아주 오랫동안 이어져 새 시템이 기존 시스템을 따라잡을 즈음이면 초창기 타이거 팀원들은 모두 떠나고 새로운 팀원들이 새 시스템을 설계하고자 나섬.
  ( ∵ 현재 시스템이 너무 엉망이어서 )

🚀 좋은 코드가 나쁜 코드로 전락하게 되는 이유

• 원래 설계를 뒤집는 방향으로 요구사항이 변했기 때문
• 일정이 촉박해 제대로 할 시간이 없었기 때문
• 멍청한 관리자와 조급한 고객, 쓸모없는 마케팅 부서 때문

🚩 그러나 결국 잘못은 전적으로 프로그래머에게 있는 것!!!

✔ 프로그래머라면 누구나 나쁜 코드가 업무 속도를 늦춘다는 사실을 익히 알지만, 기한을 맞추기 위해 나쁜 코드를 양산할 수밖에 없다고 느낌.
✔ 그러나 나쁜 코드를 양산하면 엉망진창인 상태로 인해 속도가 늦어져 결국 기한을 맞추지 못함.

🚩 기한을 맞추며 빨리 갈 수 있는 유일한 방법은 언제나 코드를 최대한 깨끗하게 유지하는 습관임.

🚀 깨끗한 코드는 어떻게 작성하나?

• 누구나 깨끗한 코드와 나쁜 코드를 구분할 줄 알더라도, 깨끗한 코드를 작성할 줄 알지는 않음.

• 깨끗한 코드를 작성하려면 '청결'이라는 힘겹게 습득한 감각을 활용해 자잘한 기법들을 적용하는 절제와 규율이 필요함.
  ✔ 여기서 키 포인트는 '코드 감각'임.
  ✔ 누군가는 그것을 타고나지만, 또 누군가는 투쟁해서 얻어야 함.
  ✔ 거기에 절제와 규율을 적용해 나쁜 코드를 좋은 코드로 바꾸는 전략도 필요함

• '코드 감각'이 없는 프로그래머도 때로는 나쁜 모듈을 알아보지만, '코드 감각' 이 있는 프로그래머는 나쁜 모듈을 보면 좋은 모듈로 개선할 방안을 떠올리고, 최고의 방안을 선택하여 계획을 세움.

🚀 깨끗한 코드란?

🚢 비야네 스트롭스트룹

C++ 창시자이자 『The C++ Programming Language』 저자

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

🌞 그에게 깨끗한 코드란!
✔ 보는 사람에게 즐거움을 선사해야 함.
✔ 세세한 사항까지 꼼꼼하게 처리하는 코드
✔ 각 함수와 클래스와 모듈은 주변 상황에 현혹되거나 오염되지 않고 한 가지 길을 걷는 코드여야 함.

🌑 나쁜 코드는 속도도 느리고 CPU 자원도 낭비하며, 보기에도 즐겁지 않으며, 또 다른 나쁜 코드를 유혹함.

🚢 데이브 토마스와 앤디 헌트

실용주의 프로그래머
✔ 나쁜 코드는 깨진 창문과도 같음.
✔ 창문이 깨진 건물은 누구도 상관하지 않는다는 인상을 풍기며 사람들도 관심을 끊음.

🚢 그래디 부치

『Object Oriented Analysis and Design with Application』 저자

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

✔ 가독성을 강조하여 깨끗한 코드가 잘 쓴 문장처럼 읽혀야 함.
✔ 코드는 추측이 아니라 사실에 기반해야 하며 반드시 필요한 내용만 담겨야 함.
✔ 코드를 읽는 사람에게 프로그래머가 단호하다는 인상을 줘야 함.

🚢 '큰' 데이브 토마스

PTO 창립자이자 이클립스 전략의 대부

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

✔ 깨끗한 코드란 다른 사람이 고치기 쉬워야 함.
✔ 테스트 케이스가 없는 코드는 깨끗한 코드가 아님.
✔ 깨끗한 코드를 만들기 위해서는 인간이 읽기 좋은 코드를 작성하면 됨.

🚢 마이클 페더스

『Working Effectively with Legacy Code』 저자

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

✔ 깨끗한 코드는 주의 깊게 작성한 코드.
✔ 즉, 누군가 시간을 들여 깔끔하고 단정하게 세세한 사항까지 꼼꼼하게 신경쓴 코드.

🚢 론 제프리스

『Extreme Programming Installed』와 『Extreme Programming Adventure in C#』 저자

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

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

✔ 중복이 있다는 것은 코드가 아이디어를 제대로 표현하지 못한다는 증거임.
✔ 표현력은 의미 있는 이름을 포함함.
✔ 여러 기능을 수행하는 객체나 메서드를 찾아서,

	1. 객체가 여러 기능을 수행한다면 여러 객체로 나눈다.
	2. 메서드가 여러 기능을 수행한다면 메서드  추출 리팩터링 기법을 적용해
	3. 기능을 명확히 기술하는 메서드 하나와 기능을 실제로 수행하는 메서드 여러 개로 나눈다.

🌝 결론적으로 깨끗한 코드를 만드는 비결이란 중복 줄이기, 표현력 높이기, 초반부터 간단한 추상화 고려하기!!

🚢 워드 커닝햄

위키 창시자. 피트 창시자. 익스트림 프로그래밍 공동 창시자

• 코드를 읽으면서 짐작했던 기능을 각 루틴이 그대로 수행한다면 깨끗한 코드라 불러도 되겠다.
• 코드가 그 문제를 풀기 위한 언어처럼 보인다면 아름다운 코드라 불러도 되겠다.

✔ 깨끗한 코드는 코드를 독해하느라 머리를 쥐어짤 필요가 없어야 함.
✔ 읽으면서 짐작한 대로 돌아가는 코드가 깨끗한 코드임.
✔ 코드가 그 문제를 풀기 위한 언어처럼 보인다는 것은 언어를 단순하게 보이도록 만든다는 것을 뜻하며 그것은 프로그래머에게 달려있음.

🚢 저자 생각

🌞 코드를 잘 짜려면 새 코드를 짜면서 끊임없이 기존 코드를 읽어야 함.

• 주변 코드를 읽지 않으면 새 코드를 짤 수 없음.
• 주변 코드가 읽기 쉬우면 새 코드를 짜기도 쉬움.
• 코드를 빠르게 짜기 위해서는 코드를 읽기 쉽게 만들면 됨.
  
  

🌞 보이스카우트 규칙

• 체크아웃할 때보다 좀 더 깨끗한 코드를 체크인한다면 코드는 절대 나빠지지 않음.
• 변수 이름 하나를 개선하고, 조금 긴 함수 하나를 분할하고, 약간의 중복을 제거하고, 복잡한 if문 하나를 정리하면 충분함.