Ch5. 형식 맞추기 프로그래머라면 형식을 깔끔하게 맞춰 코드를 짜야 한다. 코드 형식을 맞추기 위한 간단한 규칙을 정하고 그 규칙을 착실히 따라야 한다. 팀으로 일한다면 팀이 합의해 규칙을 정하고 모두가 그 규칙을 따라야 한다. 필요하다면 규칙을 자동으로 적용하는 도구를 활용한다. 형식을 맞추는 목적 코드 형식은 중요하다! 코드 형식은 의사소통의 일환. 의사소통은 전문 개발자의 일차적인 의무 적절한 행 길이를 유지하라 일반적으로 큰 파일보다 작은 파일이 이해하기 쉬움 e.g. 한 파일에 200줄 씩으로도 커다란 시스템을 구축할 수 있음 신문 기사처럼 작성하라 아주 좋은 신문 기사를 떠올려보라. 독자는 위에서 아래로 기사를 읽는다. 최상단에 기사를 몇 마디로 요약하는 표제가 나온다. 독자는 표제를 보고서..

Ch4. 주석 나쁜 코드에 주석을 달지 마라. 새로 짜라. 브라이언 W. 커니핸, P. J. 플라우거 잘 달린 주석은 그 어떤 정보보다 유용하다. 경솔하고 근거 없는 주석은 코드를 이해하기 어렵게 만든다. 사실상 주석은 기껏해야 필요악이다. 프로그래밍 언어 자체가 표현력이 풍부하다면, 아니 우리에게 프로그래밍 언어를 치밀하게 사용해 의도를 표현할 능력이 있다면, 주석은 거의 필요하지 않으리라. 아니, 전혀 필요하지 않으리라. 우리는 코드로 의도를 표현하지 못해, 그러니까 실패를 만회하기 위해 주석을 사용한다. 그러므로 주석이 필요한 상황에 처하면 곰곰이 생각하기 바란다. 상황을 역전해 코드로 의도를 표현할 방법은 없을까? 코드로 의도를 표현할 때마다 스스로를 칭찬해준다. 주석을 달 때마다 자신에게 표현력..

Ch2. 의미 있는 이름 의도를 분명히 밝혀라 변수나 함수 그리고 클래스 이름은 다음과 같은 굵직한 질문에 모두 답해야 한다. 변수 (혹은 함수나 클래스)의 존재 이유는? 수행 기능은? 사용 방법은? 따로 주석이 필요하다면 의도를 분명히 드러내지 못했다는 것 의미 있게 구분해라 컴파일러나 인터프리터만 통과하려는 생각으로 코드를 구현하면 언젠가는 문제가 생기기 마련 연속된 숫자를 덧붙이거나 불용어(의미가 불분명하거나 없어도 되는 단어)를 추가하는 방식은 적절하지 못함 이름이 달라야 한다면 의미도 달라져야 한다. 변수의 이름으로 아무런 정보를 제공 받지 못하는 예시 public static void copyChars(char a1[], char a2[]){ for (int i = 0; i < a1.lengt..

나름 이런저런 언어를 이용해서 여러가지 개발을 하고 있는데, 매번 작업했던 코드를 볼 때마다 새로운 느낌을 지울 수가 없다. 아무리 주석이 잘 되어있더라도, 그 주석이 업데이트된 코드의 내용을 반영하고 있는지도 의문이다. 그나마 기억력이 내 몸에 있는 다른 기능들보다는 좋은 편이라 약간의 시간을 들이면 기능들을 복기하는데 어려움은 없지만 그래도 더 나은 코드, 더 좋은 코드를 작성해야겠다는 생각이 들었다. 많은 사람들이 클린 XX 시리즈는 개발을 하는 사람들이 더 나은 코딩 실력을 가지기 위해서 꼭 한 번 쯤은 읽어보면 좋은 책이라고 했다. 그래서 클린 코드와 클린 아키텍쳐, 총 2 권의 책을 구매하였다. 이 책들을 읽으면서 지금 내가 개발한 환경이나 코드들을 어떻게 수정할 수 있는지 고민하고 직접 변경..