본문 바로가기

IT 서적/Clean Code5

(클린코드) 5장. 형식 맞추기 5장.형식 맞추기 프로그래머라면 형식을 깔끔하게 맞춰 코드를 짜야한다. 킴으로 일한다면 팀이 합의해 규칙을 정하고 모두가 그 규칙을 따라야한다. 형식을 맞추는 목적 적절한 행 길이를 유지하라 신문기사 처럼 작성하라 이름은 간단하면서도 설명가능하게 짓는다. 소스파일 첫 부분은 고차원 개념과 알고리즘을 설명한다. 아래로 내려갈수록 의도를 세세하게 묘사한다. 마지막에는 가장 저차원함수와 세부내역이 나온다. 개념은 빈 행으로 분리하라 빈 행은 새로운 개념을 시작한다는 시각적 단서다. 세로 밀집도 세로 밀집도는 연관성을 의미한다. 서로 밀접한 코드행은 세로로 가까이에 놓여야한다. 수직거리 변수 선언 변수는 사용하는 위치에 최대한 가까이 선언한다. 인스턴스 변수 클래스 맨 처음에 선언한다. 종속 함수 한 함수가 다.. 2022. 2. 11.
(클린코드) 4장. 주석 4장. 주석 나쁜 코드에 주석을 달지마라. 새로 짜라. - 브라이언 W. 커니핸, P.J. 플라우거 주석은 순수하게 선하지 못하다. 사실상 주석은 기껏해야 필요악이다. 프로그래밍 언어를 치밀하게 사용해 의도를 표현할 능력이 있다면 주석은 거의 필요하지 않으리라. 코드로 의도를 표현하지 못해 (실패를 만회하기 위해) 주석을 사용한다. 주석을 달 때 마다 자신에게 표현력이 없다는 사실을 푸념해야 마땅하다. 주석을 유지보수하기란 현실적으로 불가능해서 오래될수록 완전히 그릇될 가능성도 커진다. 부정확한 주석은 아예 없는 주석보다 훨씬 더 나쁘다. 부정확한 주석은 결코 이뤄지지 않을 기대를 심어준다. 진실은 한 곳에만 존재한다. 바로 코드다. 코드만이 자기가 하는 일의 정보를 정확히 제공하는 유일한 출처다. 그러.. 2022. 2. 11.
(클린코드) 3장. 함수 3장. 함수 어떤 프로그램이든 가장 기본적인 단위가 함수다. 이 장은 함수를 잘 만드는 법을 소개한다. 작게 만들어라! 함수를 만드는 첫째 규칙은 ‘작게’다. 함수를 만드는 둘째 규칙은 ‘더 작게’다. 20줄도 길다. 얼마나 짧아야 좋을까? 블록과 들여쓰기 if문/else문/while 문등에 들어가는 블록은 한 줄이어야 한다는 의미다. 이 말은 중첩 구조가 생길만큼 함수가 커져서는 안된다는 뜻이다. 그러므로 함수에서 들여쓰기 수준은 1단이나 2단을 넘어서면 안된다. 그래야 함수는 읽고 이해하기 쉬워진다. 한가지만 해라! 함수는 한가지를 해야한다. 그 한가지를 잘해야한다. 그 한가지만을 해야한다. 지정된 함수 이름 아래에서 추상화 수준이 하나인 단계만 수행한다면 그 함수는 한 가지 작업만 한다. 단순히 다.. 2022. 2. 11.
(클린코드) 2장. 의미있는 이름 2장. 의미있는 이름 들어가면서 이름을 잘 지으면 여러모로 편하다. 이름을 잘 짓는 규칙을 몇 가지 소개한다. 의도를 분명히 밝혀라 의도가 분명하게 이름을 지으라 좋은 이름을 지으려면 시간이 걸리지만 좋은 이름으로 절약하는 시간이 훨씬 더 많다. 변수/함수/클래스의 존재이유는? 수행기능은? 사용방법은? int d;//경과 시간(단위: 날짜) int elapsedTimeInDay; int daysSinceCreation; int daysSinceModification; int fileAgeInDays 의도가 들어나는 이름을 사용하면 코드 이해와 변경이 쉬워진다 코드 맥락이 코드 자체에 명시적으로 드러나게하기. 변수에 이름을 잘 붙여서 함축성을 줄이고 코드는 더 명확하게 만들 수 있다. 함수가 하는일을 이해.. 2022. 1. 26.
(클린 코드 - 로버트C. 마틴) 추천사 & 들어가면서, 1장 깨끗한 코드 👩‍💻새해를 맞아 다시 읽어보기로 마음먹은 '클린 코드' 완독하기 바라면서 기록해보고자 한다. 추천사 사소한 곳에서 발휘하는 정직은 사소하지 않다. 신은 세세함에 깃들어 있다. 큰 실무에서 실력을 쌓고 신뢰를 얻으려는 전문가는 먼저 작은 실무부터 실력을 쌓고 신뢰를 얻어야한다. 아주 사소한 것들이 전체의 매력을 깎아먹지 않게 하기위해 깨끗한 코드를 유지하는 것은 중요하다. 5S 정리, 조직, 정렬 Sort 정돈, 단정함, 체계화, Seition 청소, 정리, 광내기 Seiso 청결, 표준화 Seiketsu 생활화, 규율 Shutsuke 작은 것에도 충실한 사람이 큰 것에도 충실하다. 호미로 막을 일을 가래로 막지 마라 일찍 일어나는 새가 벌레를 잡는다 오늘 할 수 있는 일을 내일로 미루지 마라 시 란 영.. 2022. 1. 25.