본문 바로가기

개발자북클럽9

클린코드 #4 4장 주석 좋은 주석을 소개하는 장. 그리고 좋은 주석은 삭제된 주석뿐, 주석은 적을수록 좋다. 주석은 컴파일되지 않는 코드이다. 단지 프로그래머에게 유의미한 정보를 제공해주기 위해 존재하는데, 그렇지 않은 경우 프로그래밍 코드에 더해 주석을 읽고 해석하는 시간까지 소요되므로 코드 가독성을 해친다고 할 수 있다. 책에서는 주석이 자주 거짓말을 한다고 말한다. 코드가 오래될수록 주석까지 유지보수하기 어려워지고 결국 본 코드에서 멀어지게 되기 때문이다. 좋은 주석이란 꼭 주석을 통해서만 전달할 수 있는 정보를 최소한으로 기재한 주석이라고 할 수 있겠다. 1. 좋은 주석의 예시 법적 정보 제공 주석 의도와 의미를 명료히 하는 주석 결과를 경고하는 주석 TODO 주석 중요성을 강조하는 주석 공개 API에서 JS.. 2024. 3. 6.
클린코드 #3 3장 함수 클린한 함수 구현법을 소개하는 장. 함수란 프로그램의 기본 단위이므로 가독성 있는 함수란 읽는 사람이 프로그램 내부를 직관적으로 파악할 수 있는 코드를 말한다. 그를 위한 함수는 크기가 작고 한가지 일만 수행해야 한다.(아래의 순서는 내가 이해하기 쉽도록 임의로 섞어서 그룹핑 해 둔 것이다.) 1. 작게 작게 만들어라: 내부의 들여쓰기 레벨을 2단계 이하로 2. 한가지만 한가지만 해라 "함수에서 의미있는 이름으로 다른 함수를 추출할 수 있다면 그 함수는 여러 작업을 하는 셈이다." 함수당 추상화 수준은 하나로: 근본개념과 세부사항을 구분 switch 문: 사용 지양, N가지를 처리하므로 부수 효과를 일으키지 마라: 시간, 순서적 종속성이 발생함. 피치못한 경우 checkPWAndInitSess.. 2024. 3. 4.
클린코드 #1-2 1장 깨끗한 코드 책의 전체 내용을 소개하는 장. 이 책은 클린 코드와 작성법에 관한 것으로, 앞 장에서는 클린 코드의 방법론을 설명하고 뒷 장에서는 실제 코드 예시를 보여준다. 책에서 주지시키는 것처럼 클린 코드의 정의는 개발자들마다 다르며 여기서 설명하는 클린 코드의 정의와 작성법은 저자들의 주장임을 유념해야 할 것이다. 1. 클린 코드란: 깨끗한 변수 이름/깨끗한 함수/깨끗한 클래스 2. 클린 코드의 효용: 비용 절감, 개발전문가의 길 깨끗한 게 뭔데? 2장 의미 있는 이름 깨끗한 변수(/함수/클래스) 이름을 소개하는 장. 이는 의미가 분명한 변수명을 통해 코드 가독성을 높여서 협업의 효용을 높이는 데 중점을 두고 있다고 한다. 스스로도 변수명을 짓고 수정하는 작업에 너무 많은 시간과 에너지가 소요.. 2024. 3. 4.
클린코드 #0 표지처럼 발자국 찍어보자! 2024. 3. 1.