콘텐츠로 이동

4 마무리

코드의 일관성을 유지하세요.

코드를 수정해야 한다면, 몇 분 정도 시간을 내어서 코드를 살펴보고 코드에 적용된 스타일을 파악하세요. 만약 코드에서 인덱스 변수 이름에 _idx 접미사를 사용했다면, 이후에도 이 접미사를 동일하게 사용해야 합니다. 또, 주석이 해시(#)로 구성된 상자 안에 적혀있다면, 새로 추가될 주석들 또한 해시 상자로 둘러싸여 있어야 합니다.

스타일 가이드라인의 존재 의의는 공통된 어휘를 공유함으로써 대화 방식보다 대화 내용에 집중할 수 있도록 하는 데에 있습니다. 이러한 어휘를 쉽게 파악할 수 있도록 코드 전역에 적용되는 스타일 규칙을 제시했지만, 지역적으로 적용되는 스타일 또한 중요합니다. 파일에 추가되는 코드가 주변의 기존 코드와 크게 다르다면, 독자들은 코드를 읽을 때 흐름을 잃게 됩니다.

그러나 일관성에는 한계가 있습니다. 이는 지역적인 코드에서, 그리고 전역 스타일 가이드에서 명시하지 않는 세부 사항을 선택해야 할 때에 더 강하게 나타납니다. 새로운 스타일의 장점과 시간에 따라 변화해 가는 코드베이스의 경향을 무시하고, 낡은 스타일을 유지하기 위한 일반적인 정당화의 수단으로써 일관성을 이용해서는 안 됩니다.