뱅크샐러드 Go 코딩 컨벤션

간단 소개

뱅크샐러드의 Go 코딩 컨벤션은 코드 일관성 유지, 안정적인 에러 처리, 효율적인 HTTP 클라이언트 설정, 명확한 네이밍 규칙 등을 포함한다.

AI Summary

Go 코딩 컨벤션 개요
- 뱅크샐러드는 Go와 gRPC를 활발히 사용하며 코딩 컨벤션을 정립, 코드 일관성 및 개념적 일관성 유지를 목표
- golangci-lint 같은 린트 도구를 사용해 코드 규칙을 자동화
주요 코딩 프랙티스
- 프로덕션 런타임에서 panic을 지양하고, 초기화 시점에만 사용, recovery 체인 추가 권장
- 에러 핸들링 시 errors 패키지를 활용해 스택 트레이스를 추가하고, sentinel 에러는 필요한 경우에만 선언
- HTTP client 설정 시 MaxIdleConnsPerHost를 조정하여 커넥션 재사용률을 높임
- Slice 선언 시 len, cap을 미리 설정하고, nil slice를 사용하며, emptyness는 len()으로 판단
- Map 사용 시 ok 체크를 생활화하고, loop를 피하며, bool map과 struct{} map 중 선택 가능
코딩 스타일 및 프로젝트 구조
- 함수 인자 순서, 테스트 함수 네이밍, 파일 내 선언 순서 등 일관된 스타일을 유지
- import 그룹을 세 개로 나누고, 단수/복수 네이밍 규칙을 적용하며, 모호한 단어 사용을 지양
- 패키지 네이밍 시 core, util 같은 일반적인 이름 대신 구체적인 이름을 사용
- 프로젝트 구조는 필요한 패키지 폴더만 최소한으로 유지