헤더 파일¶

일반적으로 모든 .cc 파일은 연관된 .h 파일을 가져야 합니다. 단위 테스트나 main() 함수만 포함하는 작은 .cc 파일과 같은 몇 가지 일반적인 예외가 있습니다.

헤더 파일의 올바른 사용은 코드의 가독성, 크기 및 성능에 큰 차이를 만들 수 있습니다.

다음 규칙들은 헤더 파일 사용 시 발생할 수 있는 다양한 함정을 안내합니다.

이해하기 쉽게 설명하기¶

헤더 파일은 여러 소스 파일이 함께 보는 계약서에 가깝습니다. 헤더가 불완전하거나 불필요한 의존성을 많이 끌고 오면, 작은 변경도 큰 재컴파일과 예기치 않은 빌드 오류로 이어질 수 있습니다.

따라서 헤더는 자체 포함되어야 하고, 필요한 것만 직접 포함해야 하며, 포함 순서와 가드 이름도 일관되게 유지해야 합니다. 이 섹션의 하위 규칙들은 모두 헤더를 안전하고 예측 가능한 공개 경계로 만들기 위한 장치입니다.