<div id="readability-page-1" class="page"><div id="content">
		<main id="main" role="main">

		
			<article id="post-1767">
			
		<div>
			
<p>출처: 랜각코 스터디 – 책 “읽기 좋은 코드가 좋은 코드다” 1장 일부</p>



<h2 id="코드는-이해하기-쉬워야-한다">코드는 이해하기 쉬워야 한다</h2>



<p>가독성의 기본 정리: 이해하는데 들이는 시간을 최소화. 이해한다는 건 디버깅과 수정이 가능한 수준을 말함.</p>



<h3 id="표면적-수준에서의-개선">표면적 수준에서의 개선</h3>



<h4 id="이름에-정보-담기">이름에 정보 담기</h4>



<ul><li>특정한 단어 고르기: thread.stop() 보다는 완전 종료면 kill, 일시 정지면 pause가 맞음. 더 구체적인 의미를 담아라.</li><li>보편적인 이름 피하기: tmp, result, foo 같은 이름은 책임 회피. 예외도 있지만 최대한 자제하자.</li><li>추상적인 이름 대신 구체적인 이름을 사용하기: <br>DISALLOW_EVIL_CONSTRUCTORS -&gt; DISALLOW_COPY_AND_ASSIGN</li><li>접두사 혹은 접미사로 이름에 추가적인 정보 덧붙이기</li><li>이름이 얼마나 길어져도 괜찮은지 결정하기</li><li>좁은 범위에서만 사용한다면 짧은 이름도 괜찮다</li><li>긴 이름 입력은 IDE의 발전 덕분에 더 이상 귀찮지 않다.</li><li>약어와 축약형: 저자 생각은 일반적으로 받아들여지는 약어는 괜찮다.</li><li>불필요한 단어 제거하기</li><li>추가적인 정보를 담을 수 있게 이름 구성하기: 언더바, 하이픈, 대문자는 좋은 도구들. ex) 구글 C++ 컨벤션의 멤버 변수</li><li>오해할 수 없는 이름</li><li>경계를 포함하는 한계값: min/max, first/last, begin/end</li><li>boolean 변수 이름 붙이기</li><li>사용자의 기대에 부응하기: getXXX는 값을 가져오는 가벼운 메서드로 보이기 때문에 연산이 필요하면 이름을 바꾸는게 좋음.</li></ul>



<h4 id="미학">미학</h4>



<p>시각적으로 좋은 코드가 읽기도 좋다.</p>



<ul><li>일관성과 간결성을 위해서 줄 바꿈을 재정렬하기</li><li>줄 바꿈이 어렵다면 메소드를 활용하라</li><li>도움이 된다면 코드의 열을 맞춰라: 오타를 찾기 쉬워짐. 하지만 굳이 강제하진 않음. 불편하면 포기해도 됨.</li><li>의미 있는 순서를 정해서 일관성 있게 사용하라: ex) 매개변수들의 순서를 정해서 계속 같은 순서대로 초기화하고 참조하고 수정해야 함.</li><li>선언문을 블록으로 구성하라: 관련된 부분들끼리 묶어두기</li><li>코드를 문단으로 쪼개라: 논리 전개에 맞춰서 나누자.</li><li>미학은 개인적인 스타일이지만 팀이라면 일관성을 지켜야 한다.</li></ul>




			
			
								</div>
</article>

			
	
			

		
		</main>
	</div></div>

Wraithkim의 지식공방

출처: 랜각코 스터디 – 책 “읽기 좋은 코드가 좋은 코드다” 1장 일부 코드는 이해하기 쉬워야 한다 가독성의 기본 정리: 이해하는데 들이는 시간을 최소화. 이해한다는 건 디버깅과 수정이 가능한 수준을 말함. 표면적 수준에서의 개선 이름에 정보 담기 특정한 단어 고르기: thread.stop() 보다는 완전 종료면 kill, 일시 정지면 pause가 맞음. 더 구체적인 의미를 담아라. 보편적인 이름 피하기: […]

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

댓글