VIBECODING 365 / DICTIONARY
네이밍 컨벤션
Naming convention
DEFINITION
네이밍 컨벤션은 변수, 함수, 타입, 파일 같은 식별자를 어떤 규칙으로 지을지 팀이 미리 정한 약속이다. 이름이 곧 짧은 문서라서, 같은 코드라도 규칙이 맞으면 리뷰와 검색이 훨씬 수월하다. 바이브 코딩에서는 AI가 임시 이름이나 비슷한 이름을 반복하기 쉬우므로, 팀 컨벤션이 리뷰의 첫 필터가 된다.
바이브코딩365에서 다루는 웹·TypeScript 쪽의 대표 원천은 Google TypeScript Style Guide의 Naming 절이다. 여기서는 식별자에 ASCII 글자·숫자만 쓰고(상수·일부 테스트 이름에는 밑줄), 새 독자가 바로 이해할 수 있을 만큼 서술적으로 지으라고 한다. 프로젝트 밖 사람이 모르는 약어, 단어 중간 글자를 지운 축약은 피한다. 다만 열 줄 안팎의 아주 좁은 범위나 공개 API가 아닌 인자에는 짧은 이름을 허용한다.
대소문자로 역할을 구분한다
Google TS 가이드는 종류마다 케이스를 나눈다. 클래스·인터페이스·타입·열거형·데코레이터·TSX 컴포넌트 함수는 UpperCamelCase, 변수·매개변수·함수·메서드·프로퍼티는 lowerCamelCase, 모듈 수준 전역 상수와 열거형 값은 CONSTANT_CASE다. 약어는 한 단어처럼 취급해 loadHttpUrl처럼 쓰고, 플랫폼이 요구하는 XMLHttpRequest 같은 이름은 예외로 둔다. 밑줄을 앞뒤에 붙여 비공개임을 표시하는 방식은 쓰지 말라고 명시한다.
언어마다 기본값이 다르다
같은 “좋은 이름”이라도 생태계 기본 케이스는 다르다. Python PEP 8은 함수·변수에 snake_case, 클래스에 CapWords를 권한다. 중요한 것은 한 저장소 안에서 한 세트를 고수하는 일이다. 프론트는 Google TS식 camel/Pascal, 스크립트는 PEP 8식이어도 되고, 파일·폴더·URL 경로까지 팀 표로 적어 두면 AI에게도 같은 규칙을 시킬 수 있다.
리뷰에서 보는 한 줄
컨벤션은 취향 싸움이 아니라 읽기 비용을 줄이는 계약이다. 새 코드가 무엇을 담는지 이름만으로 짐작되지 않거나, 같은 개념에 tmp1·data2가 반복되면 규칙이 깨진 신호다. 포매터가 겉모양을 맞추듯, 네이밍 컨벤션은 의미 있는 단어 선택과 케이스 일관성을 맞춘다.
ENGLISH
Naming convention
EXAMPLE
errorCount, UserProfile, MAX_RETRY — 역할에 맞는 케이스
관련