읽기 좋은 코드가 좋은 코드다

책의 기본 정보

출판사

한빛미디어

출간일

2012-04-26

분량

252쪽

ISBN

9788979149142

책의 내용과 읽을 거리

『읽기 좋은 코드가 좋은 코드다』는 다른 사람이 코드를 이해할 때 걸리는 부담을 줄이는 데 초점을 맞춥니다. 이름과 주석, 코드 배치뿐 아니라 조건식과 반복, 변수의 사용, 함수의 역할을 다룹니다. 프로그램은 실행되지만 의도를 다시 파악하는 데 시간이 많이 드는 독자에게 맞는 짧은 코드 개선 안내서입니다.

이름을 고르는 부분은 단어를 예쁘게 바꾸는 문제가 아닙니다. 어떤 값을 나타내는지, 범위의 끝을 포함하는지처럼 독자가 오해하기 쉬운 정보를 어떻게 드러낼지 생각하게 합니다. 자신의 코드에서 설명을 덧붙여야만 뜻이 통하는 이름을 찾아 다른 후보와 비교해 보세요. 길어진 이름이 언제나 더 명확한지도 함께 살펴볼 일입니다.

주석과 형식에 관한 설명은 코드 밖의 글과 코드 자체가 맡을 일을 나누어 읽을 수 있습니다. 명령을 그대로 한국어로 옮기는 주석과 결정의 이유를 남기는 주석은 역할이 다릅니다. 코드를 수정할 때 함께 고쳐야 할 설명이 무엇인지 표시해 보면 주석을 늘리는 것과 이해를 돕는 일이 같은지 판단할 수 있습니다.

제어 흐름과 변수의 정리는 한 번에 생각해야 하는 요소를 줄이는 문제와 닿아 있습니다. 긴 조건식에서 확인해야 할 조건을 나누고 변수가 어느 범위에서 바뀌는지 추적해 보세요. 이때 줄 수를 줄이기만 하면 오히려 읽기 어려워질 수도 있으므로, 변경 전후의 의미를 설명하는 데 필요한 문장을 비교하는 연습이 좋습니다.

함수 수준에서 일을 나누고 테스트 코드도 읽기 쉽게 만드는 내용을 다룹니다. 테스트의 실패가 무엇을 뜻하는지 이름과 검증 문장만으로 파악할 수 있는지 살펴보세요. 테스트를 추가했다는 사실에 그치지 않고, 미래의 독자가 어떤 동작을 기대한 것인지 이해할 수 있는지도 코드 품질의 일부로 볼 수 있습니다.

짧은 코드 하나를 고른 뒤 동료가 읽는다고 가정하고 질문 목록을 만들어 보세요. 이 값의 단위는 무엇인지, 조건이 참이면 무엇을 뜻하는지, 함수가 실패하면 어떤 결과가 남는지 같은 질문입니다. 이름과 표현만으로 답할 수 있는 부분과 별도 설명이 필요한 부분을 나누면 주석을 어디에 둘지도 생각할 수 있습니다. 개선의 목표를 단순히 글자 수를 줄이는 일로 한정하지 않는 것이 중요합니다.

2012년 출간된 책이므로 최신 언어 기능이나 도구 화면을 알려 주는 목적으로 선택하지 않습니다. 이 글에서는 이름과 표현, 제어 흐름처럼 작은 코드의 의미를 전달하는 공부에 한정해 권합니다. 언어별 관용 표현과 팀의 스타일이 다를 수 있으므로 예제의 표기보다 왜 읽기 쉬워졌는지를 중심으로 가져오세요.

이 책에서 공부할 수 있는 내용

명확한 이름, 설명의 역할이 드러나는 주석, 복잡한 흐름과 변수의 정리, 하나의 일을 표현하는 함수와 테스트를 공부할 수 있습니다. 독서 후에는 짧은 코드를 고쳐 동료에게 설명 없이 읽혀 보거나 시간을 두고 스스로 다시 읽어 보세요. 이해에 필요했던 질문을 기록하는 것은 북시크가 제안하는 활용 방법입니다.

설명 방식에서 눈여겨볼 특징

• 작은 단위의 개선: 이름과 조건식처럼 지금 읽는 코드에 가까운 문제를 다룹니다.
• 독자의 이해 기준: 글자 수보다 의미를 파악하는 부담을 살피도록 돕습니다.
• 설명과 코드의 역할: 주석을 늘리는 대신 무엇을 남길지 판단하게 합니다.
• 테스트의 가독성: 검증 코드도 다음 사람이 읽을 문서로 생각하게 합니다.

이런 독자에게 권합니다

언어 기초를 익힌 뒤 코드 리뷰에서 표현과 의도를 더 명료하게 전달하고 싶은 분에게 적합합니다. 시스템의 전체 아키텍처나 최신 프레임워크 설계까지 한 번에 배우는 책은 아닙니다. 짧은 예제 하나를 고쳐 보고 변경 이유를 말하는 식으로 읽으면 목적이 선명해집니다.

작가 소개

더스틴 보즈웰과 트레버 파우커는 이해하기 어려운 코드를 분석하고 가독성 개선 방법을 정리한 이 책의 공동 저자입니다. 한국어판은 개발자이자 저술가인 임백준이 번역했습니다.

이 책과 함께 읽는 주제

• 클린 코드 책 추천: 가독성의 작은 수정과 설계까지 넓힌 코드 기준