3.9.1 이름을 잘 선택하라

좋은 이름의 중요성에 대해서는 이 장의 도입부에서 이미 다루었다. 가능한 한 코드의 기능을 명확하게 표현하거나 요약해 이름을 결정해야 한다고 이야기했다. 문맥이 완전히 명확하지 않다면 함수에 Process, DoWork, Make 등의 모호한 이름을 사용해서는 안 된다. 가끔은 평소보다 긴 이름을 사용해야 할 수도 있지만, 보통은 간결하면서도 괜찮은 이름을 만들 수 있다.

변수 이름도 마찬가지다. 루프 변수(i, j, n)나 좌표에 사용되는 x, y, z와 같이 누가봐도 명확한 경우에만 단일 문자로 된 변수 이름을 사용해야 한다. 언제나 설명이 들어간 이름을 사용하고 약어는 사용하지 않아야 한다. HTTP나 JSON과 같은 잘 알려진 이니셜이나 ID와 DB처럼 잘 알려진 약어를 사용하는 것은 괜찮지만, 일반적인 단어를 줄여서는 안 된다. 어쨌든 변수 이름은 한 번만 입력하며, 이후 나머지는 코드 자동 완성 기능으로 처리할 수 있다. 설명이 들어간 이름은 엄청난 장점을 가진다. 가장 중요한 점은 시간을 아낄 수 있다는 것이다. 설명이 담긴 이름을 고르면 변수를 사용하는 부분에 이를 설명하기 위한 문장 형태의 주석을 작성하지 않아도 된다. 사용 중인 프로그래밍 언어의 코드 작성 규칙에 대한 문서를 참고하라. 예를 들어 .NET 명명 규칙을 위한 마이크로소프트의 가이드라인 문서는 C#을 위한 훌륭한 참고 자료이다.⁷