개발자를 위한 명명 규칙 가이드

변수·함수·파일 이름을 짓는 방식은 취향처럼 보이지만, 실제로는 팀의 생산성과 코드 가독성을 좌우하는 규칙입니다.

명명 규칙이 중요한 이유

코드는 작성되는 시간보다 읽히는 시간이 훨씬 깁니다. 일관된 명명 규칙은 다른 사람은 물론 몇 달 뒤의 자신이 코드를 빠르게 이해하도록 돕습니다.

규칙이 통일되어 있으면 이름만 보고도 그것이 변수인지 상수인지 클래스인지 짐작할 수 있어, 불필요한 탐색 시간을 줄여 줍니다.

대표 표기법 한눈에 보기

• camelCase — 첫 단어는 소문자, 이후 단어의 첫 글자만 대문자 (myVariableName)
• PascalCase — 모든 단어의 첫 글자를 대문자 (MyClassName)
• snake_case — 모두 소문자에 밑줄로 단어 구분 (my_variable_name)
• CONSTANT_CASE — 모두 대문자에 밑줄, 주로 상수 (MAX_COUNT)
• kebab-case — 모두 소문자에 하이픈, 주로 URL·CSS (my-class-name)

언어·상황별 관례

많은 언어가 고유한 관례를 권장합니다. 파이썬은 변수·함수에 snake_case, 자바스크립트와 자바는 camelCase, 클래스 이름에는 대부분 PascalCase를 씁니다.

상수는 언어를 가리지 않고 CONSTANT_CASE를 쓰는 경우가 많고, URL 경로와 CSS 클래스에는 kebab-case가 사실상 표준입니다.

규칙보다 중요한 것은 일관성

어떤 표기법이 절대적으로 옳은 것은 아닙니다. 프로젝트나 팀이 정한 규칙을 끝까지 일관되게 지키는 것이 가장 중요합니다.

기존 코드베이스에 들어갈 때는 개인 취향보다 그곳의 관례를 우선하세요. 이름을 한꺼번에 바꿔야 한다면 표기법 변환 도구가 도움이 됩니다.