소프트웨어 개발을 할 때 변수나 함수 이름을 짓는 일은 생각보다 까다롭다. 언어마다 선호하는 스타일이 다르고 프로젝트 팀마다 규칙이 다르기 때문이다. 잘못된 표기법을 사용하면 코드의 가독성이 떨어지고 유지보수가 어려워진다. 여러 명의 개발자가 협업하는 환경일수록 일관된 코딩 네이밍 컨벤션 규칙을 지키는 일이 중요하다.
주요 코딩 표기법 비교
프로그래밍에서 주로 쓰이는 표기법들은 저마다 독특한 규칙과 쓰임새가 있다. 주요 표기법의 특징과 대표적인 사용처를 아래 표에 정리했다.
| 표기법 | 규칙 및 예시 | 대표적인 사용 언어 및 용도 |
|---|---|---|
| camelCase | 첫 단어는 소문자, 이후 단어는 대문자 시작 (myVariableName) | JavaScript 변수/함수, Java 메서드 |
| snake_case | 모든 단어를 소문자로 쓰고 언더바(_)로 연결 (my_variable_name) | Python 변수/함수, SQL 데이터베이스 컬럼 |
| PascalCase | 모든 단어가 대문자로 시작 (MyVariableName) | C#, Java 클래스, TypeScript 인터페이스 |
| kebab-case | 모든 단어를 소문자로 쓰고 하이픈(-)으로 연결 (my-variable-name) | CSS 클래스, URL 경로, HTML 속성 |
| UPPER_SNAKE | 모든 단어를 대문자로 쓰고 언더바(_)로 연결 (MAX_VALUE) | 상수(Constants), 환경 변수 |
상황별 최적의 표기법 선택 기준
사용 중인 프로그래밍 언어의 공식 스타일 가이드를 따르는 것이 원칙이다. 언어마다 오랜 기간 다듬어진 관습이 존재하기 때문이다.
Python을 사용한다면 PEP 8 가이드에 따라 변수와 함수는 snake_case로, 클래스는 PascalCase로 작성한다. 상수는 모두 대문자와 언더바를 조합한 UPPER_SNAKE_CASE를 쓴다. JavaScript와 TypeScript 생태계에서는 변수와 함수에 camelCase를 적용하며, 클래스나 컴포넌트 이름에는 주로 PascalCase를 쓴다.
웹 퍼블리싱이나 백엔드 API 설계 시에도 영역에 맞는 규칙이 존재한다. 데이터베이스의 테이블명이나 컬럼명은 SQL의 대소문자 무시 특성과 가독성을 고려해 snake_case를 채택하는 경우가 많다. 반면 웹 브라우저 주소창에 노출되는 URL 슬러그나 CSS 스타일시트의 클래스명은 단어 구분이 직관적인 kebab-case가 표준으로 자리 잡았다. 서로 다른 환경의 데이터를 연동하며 표기법을 일괄적으로 바꿔야 할 때는 대소문자 변환기를 활용하면 효율적이다.
개발 효율을 높이는 표기법 전환 방법
대규모 리팩토링이나 API 응답 데이터를 프론트엔드 환경에 맞게 변환하는 과정에서 수십 개의 변수명을 일일이 수정하는 일은 소모적이다. 특히 카멜케이스로 작성된 JSON 데이터를 파이썬 백엔드용 스네이크케이스로 바꾸거나 그 반대의 작업을 수행할 때 전용 도구를 쓰면 시간을 크게 아낄 수 있다.
별도의 프로그램 설치 없이 웹 브라우저 창에서 텍스트를 붙여넣고 원하는 표기법 버튼을 누르면 즉시 결과가 나온다. 사용자의 소스코드가 외부 서버에 저장되지 않고 로컬 환경에서만 연산되므로 보안 유출 걱정 없이 안심하고 활용할 수 있다.