Go 명명 규칙: 실용 가이드
Go 언어에서의 명명 규칙과 관례에 대해 설명하는 글입니다.
식별자(identifiers)는 변수, 상수, 함수, 타입 등 코드 내 이름을 의미하며, 유니코드 문자, 숫자, 밑줄만 허용되고 숫자로 시작할 수 없으며 Go 키워드는 사용할 수 없습니다.
명명 관례로는 비공개 식별자는 camelCase, 공개 식별자는 PascalCase를 사용하며, 약어는 일관된 대소문자 규칙을 지켜야 합니다. 또한, 비ASCII 문자는 가독성을 떨어뜨리므로 피하고, 내장 타입이나 함수 이름과 충돌하지 않도록 주의해야 합니다.
패키지 이름은 소문자 ASCII 문자와 숫자만 사용하며, 짧고 명확해야 하고, 표준 라이브러리 이름과 중복되지 않도록 해야 합니다. 또한, 너무 포괄적인 이름(예: utils, helpers)은 피하는 것이 좋습니다.
파일 이름은 한 단어로 요약 가능하면 좋으며, 접두사나 접미사에 따라 Go 빌드 도구가 다르게 처리하므로 주의가 필요합니다.
마지막으로, 함수, 타입, 메서드 이름에서 중복되는 단어(예: 패키지명 반복)는 피하고, 메서드 수신자는 짧고 일관된 이름을 사용하는 것이 권장됩니다. 이러한 규칙을 따르면 코드의 가독성과 유지보수성이 크게 향상됩니다.