C++ Naming Conventions: 주요 원칙 및 가이드라인

C++ Naming Conventions: 주요 원칙 및 가이드라인

 

C++ 프로젝트의 가독성과 유지보수성을 높이기 위한 명명 규칙(Naming Convention) 정리입니다.

참고 문서

• Google C++ Style Guide: https://google.github.io/styleguide/cppguide.html#Naming
• GeeksforGeeks: https://www.geeksforgeeks.org/cpp/naming-convention-in-c/

1. 주요 원칙

대상	표기법	비고
타입명	PascalCase	클래스, 구조체, 열거형 등
변수/함수명	camelCase	소문자로 시작
상수/매크로	SCREAMING_SNAKE_CASE	대문자와 _ 사용

2. 일반적인 규칙

명확한 이름 사용으로 가독성을 높여야 합니다.

• 목적을 설명하거나, 대상의 의도를 설명하는 이름을 사용합니다.
• 타인이 모를 수 있는 약어 사용을 지양합니다.
• 이름이 나타내는 뜻은 쓰이는 범위에 비례해야 합니다.

약어 처리 팁

혼합형(카멜, 파스칼 케이스)에서 약어는 하나의 단어로 간주하여 단일 대문자로 표기하는 것을 권장합니다. (예: StartRPC 보다는 StartRpc)

3. 세부 규칙

파일명

• 파일명은 모두 소문자로 작성합니다.
• _ 혹은 -를 포함할 수 있습니다.
• 일관된 로컬 규정이 없다면 _ 사용이 권장됩니다.

타입명 (Class, Struct 등)

• 단어의 첫 글자는 대문자로 작성합니다. (PascalCase)
• _를 사용하지 않습니다.
• 클래스 이름은 명사로 지정합니다.

변수명

• 변수 이름에는 _를 제외한 특수 기호를 사용하지 않습니다.

메서드/함수명

• 각 메서드 및 함수명은 동사로 시작합니다.