텍스트·데이터

카멜 케이스·스네이크 케이스 차이와 언어별 변수 표기법

다른 언어로 읽기: 日本語

카멜 케이스(camelCase)는 단어를 띄어 쓰지 않고 붙이면서 두 번째 단어부터 첫 글자를 대문자로 쓰는 방식입니다. 스네이크 케이스(snake_case)는 모든 글자를 소문자로 쓰고 단어 사이를 밑줄(_)로 잇는 방식입니다. 같은 'user id'라도 카멜 케이스로는 userId, 스네이크 케이스로는 user_id가 됩니다.

어느 쪽이 더 우수하다고 말하기는 어렵습니다. 언어와 용도마다 굳어진 관례가 있어서, 그 관례를 따르는 쪽이 정답에 가깝습니다. 변수 이름 표기법은 띄어쓰기를 쓸 수 없는 식별자에서 단어 경계를 드러내는 방법입니다. 식별자는 변수·함수·클래스·DB 컬럼처럼 프로그램 안에서 무언가를 가리키는 이름을 말합니다.

이 글에서는 카멜 케이스·스네이크 케이스를 비롯한 다섯 가지 표기법을 같은 이름으로 비교합니다. 이어서 파이썬, 자바스크립트, CSS, DB, URL에서 주로 쓰는 표기법을 정리합니다. 약어와 숫자 처리, 한 프로젝트 안에서 표기법이 섞이는 실수, 여러 이름을 한 번에 바꾸는 방법도 다룹니다.

카멜 케이스·스네이크 케이스 등 5가지 표기법 비교

같은 이름을 다섯 가지 방식으로 쓰면 아래와 같습니다. 단어가 두 개인 'user id'와 세 개인 'max retry count'를 함께 놓아야 규칙이 잘 보입니다.

표기법 user id max retry count 규칙
camelCase (카멜 케이스) userId maxRetryCount 첫 단어는 소문자, 다음 단어부터 첫 글자 대문자
PascalCase (파스칼 케이스) UserId MaxRetryCount 모든 단어의 첫 글자 대문자
snake_case (스네이크 케이스) user_id max_retry_count 모두 소문자, 밑줄로 연결
kebab-case (케밥 케이스) user-id max-retry-count 모두 소문자, 하이픈으로 연결
SCREAMING_SNAKE_CASE USER_ID MAX_RETRY_COUNT 모두 대문자, 밑줄로 연결

이름은 모양에서 왔습니다. 카멜 케이스는 중간의 대문자가 낙타 혹처럼 솟아 보이고, 케밥 케이스는 하이픈이 단어를 꼬치처럼 꿰어 놓은 모양입니다. 카멜 케이스는 '로어 카멜 케이스', 파스칼 케이스는 '어퍼 카멜 케이스'로 부르기도 합니다. 둘의 차이는 첫 글자가 소문자인지 대문자인지뿐입니다. SCREAMING_SNAKE_CASE는 대문자가 소리치는 것처럼 보인다고 붙은 이름이고, '상수 케이스(constant case)'라고도 합니다.

하이픈은 왜 변수 이름에 쓸 수 없나

파이썬·자바스크립트·자바 같은 대부분의 언어에서 user-id라고 쓰면 'user 빼기 id'라는 뺄셈으로 해석됩니다. 하이픈이 마이너스 연산자와 같은 문자이기 때문입니다. 그래서 케밥 케이스는 코드 식별자가 아닌 곳, 즉 CSS 클래스, HTML 속성, URL, 파일 이름에서 주로 씁니다.

언어·용도별로 주로 쓰는 표기법

표기법은 '어디에 쓰는 이름인가'에 따라 갈립니다. 같은 파이썬 코드 안에서도 변수와 클래스는 다른 표기법을 씁니다.

대상 주로 쓰는 표기법 예시
파이썬 변수·함수 snake_case user_id, get_user()
파이썬 클래스 PascalCase UserProfile
파이썬 상수 SCREAMING_SNAKE_CASE MAX_RETRY_COUNT
자바스크립트 변수·함수 camelCase userId, getUser()
자바스크립트 클래스 PascalCase UserProfile
CSS 클래스·속성 kebab-case .user-card, background-color
HTML data 속성 kebab-case data-user-id
DB 테이블·컬럼 snake_case user_id, created_at
URL 경로 kebab-case /blog/user-guide/
환경 변수 SCREAMING_SNAKE_CASE DATABASE_URL

파이썬: PEP 8 기준

PEP 8은 파이썬 표준 라이브러리 코드를 위해 작성된 스타일 가이드로, 대부분의 파이썬 프로젝트가 기준으로 삼습니다. 함수와 변수는 소문자와 밑줄(snake_case), 클래스는 단어 첫 글자를 대문자로(CapWords, 즉 PascalCase), 모듈 수준 상수는 대문자와 밑줄로 쓰도록 권합니다. 모듈(파일) 이름도 짧은 소문자를 권하며, 읽기 좋아진다면 밑줄을 써도 됩니다.

파일 이름에 하이픈을 넣으면 import user-utils처럼 가져올 수 없습니다. 파이썬 파일 이름도 스네이크 케이스로 쓰는 편이 안전합니다.

자바스크립트와 CSS가 만나는 곳

자바스크립트에는 PEP 8처럼 언어가 정한 단일 공식 가이드가 없습니다. 그래도 내장 API가 일관된 본보기가 됩니다. getElementById처럼 메서드는 카멜 케이스, Date·Promise처럼 생성자는 파스칼 케이스, Number.MAX_SAFE_INTEGER처럼 상수는 대문자 스네이크 케이스입니다.

CSS의 케밥 케이스 이름은 자바스크립트에서 카멜 케이스로 바뀝니다. CSS 속성 background-color는 자바스크립트에서 element.style.backgroundColor로 접근합니다. HTML 속성 data-user-id의 값은 element.dataset.userId로 읽습니다. 이 변환 규칙은 MDN의 dataset 문서에 정리되어 있습니다.

DB 컬럼: 스네이크 케이스가 기본인 이유

SQL은 따옴표로 감싸지 않은 식별자의 대소문자를 구분하지 않는 경우가 많습니다. 예를 들어 PostgreSQL은 따옴표 없는 이름을 소문자로 바꿔 저장합니다. 그래서 userId로 만든 컬럼은 실제로는 userid가 되어 단어 경계가 사라집니다.

대소문자를 살리려고 "userId"처럼 따옴표로 만들면, 이후 모든 쿼리에서 따옴표를 붙여야 합니다. 밑줄은 대소문자 처리 방식과 상관없이 경계가 유지되므로 user_id가 가장 탈이 적습니다. MySQL에서는 테이블 이름의 대소문자 구분이 운영체제와 서버 설정에 따라 달라지므로, 처음부터 소문자로 통일해 두면 편합니다.

URL: 하이픈을 쓰는 이유

URL 경로는 사람이 읽고 검색 엔진도 해석하는 텍스트입니다. Google은 URL 구조 가이드에서 단어 구분에 밑줄 대신 하이픈을 쓰도록 권합니다. 이 블로그의 주소도 /blog/what-is-base64/처럼 케밥 케이스를 씁니다.

URL 경로는 서버에 따라 대소문자를 구분하기도 합니다. 그래서 /User-Guide/와 /user-guide/가 서로 다른 페이지로 취급될 수 있으니 소문자로 통일하는 편이 좋습니다. 경로에 한글을 넣으면 %EC%82%AC처럼 퍼센트 인코딩되어 길어집니다. 실제로 어떻게 바뀌는지는 URL 인코딩 도구로 확인할 수 있습니다.

약어 표기: HTTPServer와 HttpServer 중 무엇이 맞나

'HTTP server'나 'user ID'처럼 약어가 들어가면 표기법이 갈립니다. 약어를 모두 대문자로 둘지, 일반 단어처럼 첫 글자만 대문자로 쓸지의 문제입니다.

방식 예시 이 방식을 쓰는 가이드
약어 전체를 대문자로 HTTPServer, userID PEP 8: 클래스 이름 속 약어는 모두 대문자(HTTPServerError)
약어를 한 단어처럼 HttpServer, userId Google 자바 스타일 가이드(XmlHttpRequest, customerId)
글자 수에 따라 다르게 IOStream, HtmlTag Microsoft .NET 지침: 두 글자 약어는 모두 대문자, 세 글자 이상은 첫 글자만

현실의 코드는 이마저도 섞여 있습니다. 브라우저의 XMLHttpRequest는 XML은 전부 대문자, Http는 첫 글자만 대문자입니다. 오래된 API일수록 이런 혼용이 남아 있습니다.

변환할 때는 '한 단어처럼'이 유리합니다

표기법을 기계적으로 바꿀 때 차이가 드러납니다. '첫 글자를 제외한 대문자 앞에 밑줄을 넣고 소문자로 바꾼다'는 단순한 규칙으로 스네이크 케이스를 만들면 결과는 다음과 같습니다.

  1. HttpServer → http_server (의도대로 변환)
  2. userId → user_id (의도대로 변환)
  3. userID → user_i_d (약어가 글자 단위로 쪼개짐)
  4. HTTPServer → h_t_t_p_server (같은 문제)

좀 더 정교한 변환 규칙은 두 가지 기준으로 끊습니다. 소문자나 숫자 뒤에 대문자가 오면 그 앞에서 끊고, 연속된 대문자 다음에 대문자+소문자가 오면 그 대문자 앞에서 끊습니다. 많은 변환 라이브러리가 이 방식으로 HTTPServer를 http_server로, userID를 user_id로 바꿉니다.

하지만 userIDs처럼 약어 뒤에 소문자가 붙으면 user_i_ds로 쪼개지기 쉽습니다. 반대로 user_id를 카멜 케이스로 되돌릴 때는 원래 이름이 userId였는지 userID였는지 알 수 없습니다. 도구마다 결과가 다를 수 있습니다.

정리하면 이렇습니다. 언어 공식 가이드가 정해 둔 방식이 있으면 그것을 따릅니다. 정해진 방식이 없으면 약어를 한 단어처럼 쓰는 쪽이 변환과 검색에서 덜 헷갈립니다. userIds는 어떤 규칙으로도 user_ids가 되고, 되돌려도 다시 userIds가 되기 때문입니다. 참고로 스네이크 케이스에서는 두 방식 모두 http_server가 되어 이 고민이 사라집니다.

숫자가 들어간 이름 처리

숫자는 대문자도 소문자도 아니어서, 변환 규칙이 가장 모호해지는 지점입니다. 자주 부딪히는 경우는 세 가지입니다.

숫자로 시작할 수 없습니다

파이썬과 자바스크립트 식별자는 숫자로 시작할 수 없습니다. 2nd_place는 오류이므로 second_place나 place_2로 바꿔야 합니다. CSS도 마찬가지입니다. HTML에 class="2col"이라고 쓸 수는 있지만, 선택자에서 .2col로 바로 쓰지 못하고 이스케이프(특수 문자 처리)가 필요합니다.

숫자 앞뒤에서 끊을지가 도구마다 다릅니다

base64Encode를 스네이크 케이스로 바꾸면 base64_encode가 될 수도 있고, base_64_encode가 될 수도 있습니다. utf8, ipv6, address2도 같은 문제가 생깁니다. 숫자를 앞 단어의 일부로 보는 쪽(base64, utf8)이 원래 뜻을 지키므로, 변환 후에는 숫자 주변을 반드시 확인합니다.

번호를 매길 때는 자릿수를 맞춥니다

파일이나 키 이름에 일련번호를 붙이면 정렬 문제가 생깁니다. 프로그램 코드의 정렬 함수, DB의 ORDER BY, 명령줄의 ls처럼 문자열을 그대로 정렬하면 image_1, image_2, image_10은 image_1, image_10, image_2 순서가 됩니다. 문자열은 한 글자씩 비교하므로 '1' 다음 글자 '0'이 '2'보다 앞서기 때문입니다.

Windows 파일 탐색기나 macOS Finder처럼 숫자를 크기 순으로 정렬해 주는 프로그램에서는 이 문제가 보이지 않을 수 있습니다. 하지만 같은 파일을 서버나 클라우드 저장소 목록에서 보면 순서가 달라집니다. 100개 미만이라면 image_01처럼 두 자리로 맞추면 어디서든 같은 순서가 나옵니다.

한 프로젝트 안에서 표기법이 섞이는 실수

표기법 자체보다 더 큰 문제는 혼용입니다. 같은 값을 가리키는 이름이 두 가지 모양으로 존재하면 오타와 버그가 생깁니다.

  • API와 프런트엔드의 경계: 서버가 {"user_id": 1}처럼 스네이크 케이스 JSON을 보내고, 자바스크립트 쪽은 카멜 케이스를 쓰는 경우입니다. 그대로 두면 user.user_id와 user.userId가 한 코드에 섞입니다. 변환을 응답을 받는 한 곳에서만 하거나, 서버 형식을 그대로 쓰기로 정합니다.
  • DB에 따옴표 컬럼이 하나만 섞인 경우: 대부분 created_at인데 "updatedAt" 하나만 따옴표로 만들어져 있으면, 그 컬럼만 쿼리에서 계속 따옴표가 필요합니다.
  • 약어 표기 혼용: userId와 userID, apiUrl과 apiURL이 함께 있으면 자동 완성으로도 틀린 쪽을 고르기 쉽습니다.
  • 파일 이름의 대소문자만 바꾸기: Windows와 macOS는 기본 설정에서 파일 이름의 대소문자를 구분하지 않고, 리눅스는 구분합니다. UserCard.js를 userCard.js로 바꿔도 내 컴퓨터에서는 문제가 없습니다. 하지만 리눅스 서버에서는 불러오기가 실패할 수 있고, Git이 이 변경을 감지하지 못하기도 합니다.

혼용을 막는 가장 확실한 방법은 규칙을 문서로 남기고 검사를 자동화하는 것입니다. 많은 언어의 린터(코드 규칙 검사 도구)와 포매터가 이름 규칙 검사를 지원하므로, 사용하는 도구의 설정을 확인해 보는 것이 좋습니다.

대소문자 변환 도구로 여러 이름 한 번에 바꾸기

DB 컬럼 목록을 자바스크립트 객체 키로 옮기거나, 기획서의 영문 항목명을 상수 이름으로 바꿀 때는 하나씩 고치기보다 한 번에 변환하는 편이 빠르고 실수도 적습니다. 대소문자 변환 도구를 쓰면 영문을 대문자, 소문자, 카멜 케이스, 스네이크 케이스로 바꿀 수 있습니다. 상수 이름(SCREAMING_SNAKE_CASE)은 스네이크 케이스로 바꾼 뒤 대문자 변환을 한 번 더 적용하면 됩니다.

예시: DB 컬럼을 카멜 케이스로 바꾸기

다음 세 컬럼을 자바스크립트 키로 바꾼다고 하겠습니다.

  1. 변환할 이름을 복사합니다. 예시는 user_id, created_at, profile_image_url입니다.
  2. 도구 입력란에 붙여 넣고 카멜 케이스 변환을 선택합니다.
  3. 결과가 userId, createdAt, profileImageUrl인지 확인합니다. 여러 줄을 넣었다면 줄마다 따로 변환되었는지도 봅니다.
  4. 약어와 숫자 주변을 점검합니다. 팀 규칙이 약어 전체 대문자라면 profileImageURL로 직접 고칩니다.
  5. 결과를 복사해 코드나 문서에 붙여 넣습니다.

이미 코드에 있는 이름은 '이름 바꾸기' 기능으로

텍스트 변환 도구는 새 이름을 만들거나 목록을 정리할 때 적합합니다. 이미 코드에서 쓰고 있는 변수 이름을 바꿀 때는 텍스트 찾아 바꾸기보다 코드 편집기의 '기호 이름 바꾸기(리팩터링)' 기능이 안전합니다.

단순 찾아 바꾸기로 user_id를 userId로 바꾸면 super_user_id 같은 다른 이름의 일부까지 바뀝니다. 문자열이나 주석 속 단어도 함께 바뀝니다. 리팩터링 기능은 그 변수를 실제로 참조하는 곳만 골라 바꿉니다. 지원 여부와 사용법은 편집기와 언어에 따라 다릅니다.

표기법 선택 빠른 참고

새 이름을 지을 때 아래 순서로 확인하면 대부분의 경우가 정리됩니다.

  • 언어 공식 가이드가 있나: 파이썬이면 PEP 8을 따릅니다. 변수·함수는 snake_case, 클래스는 PascalCase, 상수는 SCREAMING_SNAKE_CASE입니다.
  • 코드 식별자인가: 자바스크립트 변수·함수는 camelCase, 클래스는 PascalCase입니다. 하이픈은 쓰지 않습니다.
  • CSS·HTML·URL인가: 케밥 케이스를 쓰고 소문자로 통일합니다.
  • DB 컬럼인가: snake_case 소문자로 쓰고, 따옴표가 필요한 이름은 만들지 않습니다.
  • 환경 변수나 설정 상수인가: SCREAMING_SNAKE_CASE를 씁니다.
  • 약어가 있나: 프로젝트 안에서 Id와 ID 중 하나로 정하고 문서에 적어 둡니다. 복수형(Ids/IDs)도 함께 정합니다.
  • 숫자가 있나: 숫자로 시작하지 않게 하고, 일련번호는 자릿수를 맞춥니다.
  • 일괄 변환 후: 약어와 숫자 주변 결과를 눈으로 한 번 더 확인합니다.

자주 묻는 질문

카멜 케이스와 파스칼 케이스는 같은 표기법인가요?

단어를 붙여 쓰고 단어 첫 글자를 대문자로 올린다는 원리는 같고, 맨 첫 글자만 다릅니다. userId처럼 소문자로 시작하면 카멜 케이스, UserId처럼 대문자로 시작하면 파스칼 케이스입니다. 그래서 각각 로어 카멜 케이스, 어퍼 카멜 케이스라고 부르기도 합니다.

JSON 키 이름은 카멜 케이스와 스네이크 케이스 중 무엇을 써야 하나요?

JSON 형식 자체는 키 이름 표기법을 정하지 않으므로 둘 다 문법상 문제가 없습니다. 서비스마다 관례가 달라 userId와 user_id가 모두 널리 쓰입니다. 주로 그 데이터를 쓰는 쪽 언어의 관례에 맞추고, 한 API 안에서는 하나로 통일하는 것이 핵심입니다.

변수 이름에 한글을 써도 되나요?

파이썬 3와 자바스크립트는 유니코드 문자로 된 식별자를 허용하므로 문법상으로는 한글 변수명도 동작합니다. 다만 한글에는 대소문자가 없어 카멜 케이스 같은 구분을 쓸 수 없습니다. 또 일부 도구나 협업 환경에서 불편할 수 있어, 공개 코드나 팀 프로젝트에서는 영문 이름을 쓰는 경우가 일반적입니다.

파일 이름은 어떤 표기법으로 짓는 것이 좋나요?

웹 자원이나 문서 파일은 케밥 케이스, 파이썬 모듈은 import 문법 때문에 스네이크 케이스가 무난합니다. 자바스크립트 컴포넌트 파일은 프로젝트에 따라 파스칼 케이스를 쓰기도 합니다. 어떤 방식이든 운영체제마다 대소문자 구분이 다르므로, 대소문자만 다른 두 파일 이름은 만들지 않는 편이 안전합니다.