[Clean Code] 1장. 깨끗한 코드

[들어가기]

장인정신이 필요하다!

첫째, 장인에게 필요한 원칙, 패턴, 기법, 경험이라는 지식을 습득해야 한다.

둘째, 열심히 일하고 연습해 지식을 몸과 마음으로 체득해야 한다.

 

깨끗한 코드를 작성하는 방법을 배우기는 어렵다. 단순히 원칙과 패턴을 안다고 깨끗한 코드가 나오지 않는다. 고생을 해야 한다. 스스로 연습하고 실패도 맛봐야 한다. 남들이 시도하다 실패하는 모습도 봐야한다. 그들이 넘어지고 일어서는 모습도 봐야한다. 결정을 내리느라 고민하는 모습, 잘못된 결정으로 대가를 치르는 모습도 봐야한다.

-> 정말 공감가는 문장이였습니다! 아직 저는 초급 개발자라 공부해야할것도 많고 경험도 부족해서 더 많은 노력을 해야 한다고 생각합니다. 깨끗한 코드를 짜기 위해 노력하기 보단... 빠르게 기능을 개발하기 위해 노력하지 않았나 반성하며... 깨끗한 코드를 많이 보면서 배워나가야겠습니다! 그럼 깨끗한 코드를 위해 클린 코더를 한번 정독해 보겠습니다! 👍

 

---

[1장. 깨끗한 코드]

- 르블랑의 법칙 : '나중은 결코 오지 않는다'

- 나쁜 코드가 쌓일 수록 팀 생산성은 떨어진다. 

- 좋은 코드를 사수하는 일은 바로 우리 프로그래머들의 책임이다. 나쁜 코드의 위험을 이해하지 못하는 관리자 말을 그대로 따르는 행동은 전문가 답지 못하다.

- 기한을 맞추는 유일한 방법은, 그러니깐 빨리 가는 유일한 방법은, 언제나 코드를 최대한 깨끗하게 유지하는 습관이다. (나쁜 코드로 인해 속도가 느려짐에 따라 기한을 맞추지 못한다.)

 

깨끗한 코드를 작성하기 위해서?

: 코드 감각이 필요하다! 코드감각이 있으면 좋은 코드와 나쁜코드를 구분한다. 그뿐만이아니라, 절제와 규율을 적용해 나쁜코드를 좋은 코드로 바꾸는 전략도 파악한다.

 

---

 

비야네 스트롭스트룹 (C++ 창시자)

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

 

- 깨끗한 코드는 보는 사람에게 즐거움을 선사해야 한다.

- CPU 자원을 낭비하는 코드도 바람직 하지 않다.

- 프로그래머들이 대충 넘어가는 부분중 하나가 오류처리인데, 메모리 누수, 경쟁 상태, 일관성 없는 명명법 과 같이 세세한 사항까지 꼼꼼하게 처리하는 코드가 깨끗한 코드이다.

- 깨끗한 코드는 한가지에 '집중'한다. 각 함수와 클래스와 모듈은 주변 상황에 현혹되거나 오염되지 않은 채 한길만 걷는다.

 

그래디 부치

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

 

- 잘 쓴 문장처럼 읽히는 가독성을 강조한다.

- 코드는 추측이 아니라 사실에 기반해야 한다. 반드시 필요한 내용만 담아야 한다. 코드를 읽는 사람에게 프로그래머가 단호하다는 인상을 줘야한다.

 

데이브 토마스

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

 

- 깨끗한 코드란 고치기 쉽다.

- 테스트 케이스가 없는 코드는 깨끗한 코드가 아니다. 아무리 코드가 우아해도, 아무리 가독성이 높아도, 테스트 케이스가 없으면 깨끗하지 않다.

 

마이클 페더스

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

 

- 세세한 사항까지 신경쓴 코드

 

론 제프리스

"모든 테스트를 통과하다. 중복이 없다. 시스템 내 모든 설계 아이디어를 표현한다. 클래스, 메서드, 함수 등을 최대한 줄인다. 물론 나는 주로 중복에 집중한다. 같은 작업을 여러 차례 반복한다면 코드가 아이디어를 제대로 표현하지 못한다는 증거다. 나는 문제의 아이디어를 찾아내 좀 더 명확하게 표현하려고 애쓴다.

내게 있어 표현력은 의미 있는 이름을 포함한다. 보통 나는 확정되기 전에 이름을 여러 차례 바꾼다.

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

중복과 표현력만 신경써도 깨끗한 코드라는 목표에 성큼 다가선다. 오랜 경험 끝에 모든 프로그램이 아주 유사한 요소로 이뤄진다는 사실을 깨달았다. 한가지 예가 '집합에서 항목 찾기'다. 어떤 집합에서 특정 항목을 찾아낼 필요가 자주 생긴다. 이런 경우에는 추상 메서드나 추상 클래스를 만들어 실제 구현을 감싼다. 그러면 여러가지 장점이 생긴다.

중복 줄이기, 표현력 높이기, 초반부터 간단한 추상화 고려하기 이 3가지가 깨끗한 코드를 만드는 비결이다."

 

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

 

워드 커닝햄

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

 

---

 

- 우리는 새 코드를 짜면서 끊임없이 기존코드를 읽는다. 그러므로 읽기 쉬운 코드가 매우 중요하다. 그러므로 쉽게 새 코드를 짜려면 읽기 쉽게 코드를 짜면 된다.

 

보이스카우트 규칙

잘 짠 코드가 전부가 아니다. 시간이 지나도 언제나 깨끗하게 유지해야한다

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

체크아웃할 때 보다 좀 더 깨끗한 코드를 체크인한다면 코드는 절대 나빠지지 않는다. 한꺼번에 많은 시간과 노력을 투자해 코드를 정리할 필요가 없다. 그냥 변수 이름 하나 개선하고, 긴 메소드 분할하고, 중복 쪼끔 제거하고 이러는것도 충분하다.

 

- 예술에 대한 책을 읽는다고 예술가가 된다는 보장은 없다. 즉, 이 책을 읽는다고 뛰어난 프로그래머가 된다는 보장은 없다. "코드감각"을 확실히 얻는다는 보장도 없다. 단지 이 책은 뛰어난 프로그래머가 생각하는 방식과 그들이 사용하는 기술과 기교와 도구를 소개할 뿐이다.