본문 바로가기

독서/클린 코드11

클린 코드 (Clean Code) - 5장 형식 맞추기 노션 정리 5장 형식 맞추기 책에서 기억하고 싶은 내용을 써보세요. sondho.notion.site 😃 책에서 기억하고 싶은 내용을 써보세요. 코드 형식을 맞추기 위한 간단한 규칙을 정하고 그 규칙을 따라야 한다. 팀으로 일한다면 팀이 합의해 규칙을 정하고 모두가 그 규칙을 따라야 한다. 필요하다면 규칙을 자동으로 적용하는 도구를 활용한다. 형식을 맞추는 목적 코드 형식은 의사소통의 일환이다. 의사소통은 전문 개발자의 일차적인 의무다. 코드가 바뀌어도 맨 처음 잡아놓은 구현 스타일과 가독성 수준은 유지보수 용이성과 확장성에 계속 영향을 미친다. 원래 코드는 사라질지라도 개발자의 스타일과 규율은 사라지지 않는다. 적절한 행 길이를 유지하라 일반적으로 큰 파일보다 작은 파일이 이해하기 쉽다. 신문 기사처럼.. 2022. 2. 8.
클린 코드 (Clean Code) - 4장 주석 노션 정리 4장 주석 책에서 기억하고 싶은 내용을 써보세요. sondho.notion.site 😃 책에서 기억하고 싶은 내용을 써보세요. 나쁜 코드에 주석을 달지 마라. 새로 짜라. 브라이언 W. 커니핸, P.J.플라우거 때때로 주석 없이는 자신을 표현할 방법을 찾지 못해 할 수 없이 주석을 사용한다. 코드는 언제나 변한다. 주석이 언제나 코드를 따라가지 않는다. 부정확한 주석은 아예 없는 주석보다 나쁘다. 코드만이 정확한 정보를 제공하는 유일한 출처다. 그러므로 주석을 가능한 줄이도록 노력해야한다. 주석은 나쁜 코드를 보완하지 못한다. 자신이 저지른 난장판을 주석으로 설명하려 애쓰는 대신에 그 난장판을 깨끗이 치우는 데 시간을 보내라! 코드로 의도를 표현하라! 주석으로 달려는 설명을 함수로 만들어 표현.. 2022. 2. 7.
클린 코드 (Clean Code) - 3장 함수 노션 정리 3장 함수 책에서 기억하고 싶은 내용을 써보세요. sondho.notion.site 😃 책에서 기억하고 싶은 내용을 써보세요. 작게 만들어라! 작은 함수가 좋다. 블록과 들여쓰기 if 문 / else 문 / while 문 등에 들어가는 블록은 한 줄이어야 한다. 대개 거기서 함수를 호출한다. 그러면 바깥을 감싸는 함수(enclosing function)가 작아질 뿐 아니라, 블록 안에서 호출하는 함수 이름을 적절히 짓는다면, 코드를 이해하기도 쉬워진다. 중첩 구조가 생길만큼 함수가 커져서는 안 된다. 한 가지만 해라! 함수는 한 가지를 해야 한다. 그 한 가지를 잘 해야 한다. 그 한 가지만을 해야 한다. 지정된 함수 이름 아래에서 추상화 수준이 하나인 단계만 수행한다면 그 함수는 한 가지 작.. 2022. 2. 4.
클린 코드 (Clean Code) - 2장 의미 있는 이름 노션 정리 2장 의미 있는 이름 책에서 기억하고 싶은 내용을 써보세요. sondho.notion.site 😃 책에서 기억하고 싶은 내용을 써보세요. 의도를 분명히 밝혀라 변수나 함수 그리고 클래스 이름은 다음과 같은 질문에 모두 답해야 한다. 따로 주석이 필요하다면 의도를 분명히 드러내지 못했다는 말이다. 존재 이유는? 수행 기능은? 사용 방법은? 그릇된 정보를 피하라 나름대로 널리 쓰이는 의미가 있는 단어를 다른 의미로 사용하면 안 된다. e.g. hp, aix, sco ⇒ 유닉스 플랫폼이나 유닉스 변종을 가리키는 이름 여러 계정으로 그룹을 묶을 때, 실제 List가 아니라면 accountList라 명명하지 않는다. → accountGroup, bunchOfAccounts, Accounts 서로 흡사한.. 2022. 1. 23.