클린코드 4장 - 주석 ❗주석에 대하여 주석이 필요한 상황에 처하면 곰곰이 생각해야 한다. 반대로 생각해서 반대로 코드로 의도를 표현할 방법이 없는지 생각해야 한다. 코드로 의도를 표현할 때마다 스스로 칭찬하며 주석을 달 때마다 자신에게 표현력이 없다는 사실을 푸념해야 마땅하다. 프로그래머들이 주석을 유지하고 보수하는 것은 현실적으로 불가능하기 때문에 주석이 코드와 분리되어 의미가 전해지지 않는 경우도 많이 존재한다. 그래서 프로그래머들이 주석을 엄격하게 관리하고 복구성과 관련성, 정확성이 언제나 높아야 한다고 주장할지도 모르지만 필자는 표현력을 강화해서 주석이 필요없는 방향으로 에너지를 쏟는 게 낫다고 생각한다. ❗주석은 나쁜 코드를 보안하지 못한다 코드에 주석을 추가하는 일반적인 이유는 코드 품질이 ..

클린 코드 3장 - 함수 ❗한 가지만 해라 함수는 한 가지 일만 해야하고 그 일만 잘 해야 한다. 함수가 한 가지 작업만 하려면 함수 내 모든 문장의 추상화 수준이 동일해 한다. 한 함수 내에서 추상화 수준을 섞으면 코드를 읽는 사람이 헷갈리기 때문이다 ❗서술적인 이름을 사용하라 함수가 하는 일을 좀 더 잘 표현하는 이름이 좋은 함수 이름이다. 코드를 읽으면서 짐작했던 기능을 각 루틴이 그대로 수행한다면 깨끗한 코드라고 부를 수 있다. 그래서 한 가지만 하는 작은 함수에 좋은 이름을 붙인다면 이런 원칙을 달성함에 있어 이미 절반은 성공한 것이다. 함수가 작고 단순할수록 서술적인 이름을 고르기도 쉬워진다. 서술적인 이름을 사용하면 개발자 머릿속에서도 설계가 뚜렷해지므로 코드를 개선하기 쉬워진다. 또한 이름..

클린코드 2장 - 의미 있는 이름 ❗의도를 분명하게 밝혀라 / 그릇된 정보를 피하라 좋은 이름을 지으려면 시간이 걸리지만 좋은 이름으로 절약하는 시간이 훨씬 많다 변수나 함수, 클래스가 존재하는 이유와 수행 기능, 사용 방법에 대한 것을 따로 주석으로 작성해야 한다면 의도를 분명하게 드러내지 못했다는 것이다 그릇된 단서는 코드의 의미를 흐리기 때문에 남겨서는 안 된다 나름대로 널리 쓰이는 의미가 있는 단어를 다른 의미로 사용해도 안 된다 일관성이 떨어지는 정보도 그릇된 정보다. ❗의미 있게 구분하라 컴파일러나 인터프리터만을 통과하려는 생각으로 코드를 구현하는 프로그래머는 스스로 문제를 일으킨다 컴파일러를 통과할지라도 연속된 숫자를 덧붙이거나 불용어(noise word)를 추가하는 방식은 적절하지 못하다 ..

❗코드가 존재하리라 코드는 요구사항을 상세히 표현하는 수단으로 기계가 실행할 정도로 상세하게 요구사항을 명시하는 작업을 프로그래밍이라고 한다. 요구사항에 더욱 가까운 언어를 만들 수도 있고, 요구사항에서 정형 구조를 뽑아내는 도구를 만들 수는 있지만 어느 순간 정밀한 표현이 필요하기 때문에 코드는 항상 존재할 것이다. ❗나쁜 코드 프로그래머라면 누구나 당연히 나쁜 코드로 고생한 경험이 있다. 우리 모두는 자신이 짠 쓰레기 코드를 쳐다보며 나중에 고쳐야겠다고 생각한 경험 또한 있다. 하지만 결코 나중은 오지 않는다 ❗나쁜 코드로 치르는 대가 나쁜 코드는 개발 속도를 크게 떨어뜨린다. 코드를 고칠 때마다 엉뚱한 곳에서 문제가 생기고 시간이 지날수록 나쁜 코드가 쌓여져 간다. 또한 나쁜 코드는 팀 생산성을 떨..