가독성

의미 있는 이름

변수 이름을 정할 때 가장 중요한 것은 가독성입니다. 변수 이름이 의미를 명확하게 전달해야 코드를 읽는 사람이 쉽게 이해할 수 있습니다.

의미 있는 이름을 사용하면, 코드를 처음 접하는 사람도 변수의 용도를 쉽게 파악할 수 있어요. 예를 들어, 사용자의 나이를 저장하는 변수의 경우 ‘userAge’와 같이 직관적인 이름을 사용하는 것이 좋습니다. 이렇게 하면, 변수 이름만 봐도 어떤 데이터가 저장되어 있는지 쉽게 알 수 있죠.

축약어 사용 최소화

변수 이름을 짓는 데 있어 축약어 사용을 최소화하는 것도 중요합니다. 축약어를 사용하면 이름이 간결해지지만, 가독성이 떨어질 수 있어요. 예를 들어, ‘accumulator’를 ‘acc’로 줄이는 경우, 코드를 읽는 사람이 ‘acc’가 무엇을 의미하는지 한 번에 이해하기 어려울 수 있습니다.

축약어를 사용하는 대신, 전체 단어를 사용하여 변수 이름을 지으면 더 명확한 의미 전달이 가능합니다. 물론, 널리 알려진 축약어나 단어는 예외로 취급할 수 있습니다. (예: ‘id’는 ‘identifier’의 줄임말로 널리 사용되므로 충분히 이해 가능하다고 볼 수 있죠.)

일관된 네이밍 규칙

일관된 네이밍 규칙을 사용하면 코드의 가독성이 높아집니다. 프로젝트 전체에서 동일한 규칙을 따르면, 새로운 코드를 읽는 사람이나 다른 팀원들이 더 쉽게 이해할 수 있어요. 일관성 있는 네이밍은 변수뿐만 아니라 함수, 클래스 등 모든 코드 작성에 적용되어야 합니다.

예를 들어, 모든 변수에 카멜 케이스(camelCase)를 사용하고 있다면, 새로운 변수도 동일한 방식으로 지어야 합니다.

일관된 네이밍 규칙

형식

카멜 케이스 (camelCase)

카멜 케이스는 변수 이름의 각 단어의 첫 글자를 대문자로 표기하는 방식입니다. 단, 첫 단어의 첫 글자는 소문자로 표기합니다. 이 방식은 자바, 자바스크립트 등 여러 프로그래밍 언어에서 권장되는 네이밍 규칙입니다.

예를 들어, ‘userName’이나 ‘totalPrice’처럼 표기하는 것이 카멜 케이스입니다. 카멜 케이스를 사용하면 단어 사이의 경계를 명확하게 표시할 수 있어 가독성이 좋아집니다.

스네이크 케이스 (snake_case)

스네이크 케이스는 변수 이름의 각 단어를 소문자로 표기하고, 단어 사이에 언더스코어(_)를 사용하는 방식입니다. 이 방식은 파이썬, 루비 등 여러 프로그래밍 언어에서 권장되는 네이밍 규칙입니다. 예를 들어, ‘user_name’이나 ‘total_price’처럼 표기하는 것이 스네이크 케이스입니다.

스네이크 케이스를 사용하면 단어 사이의 경계를 명확하게 표시할 수 있으며, 모든 문자를 소문자로 표기하는 것이 특징입니다.

파스칼 케이스 (PascalCase)

파스칼 케이스는 카멜 케이스와 비슷하지만, 첫 단어의 첫 글자도 대문자로 표기하는 방식입니다. 이 방식은 클래스 이름 등을 지을 때 사용되는 경우가 많습니다.

예를 들어, ‘UserName’이나 ‘TotalPrice’처럼 표기하는 것이 파스칼 케이스입니다. 파스칼 케이스를 사용하면 단어 사이의 경계를 명확하게 표시할 수 있고, 변수와 클래스를 구분하기 쉬워집니다.

케밥 케이스 (kebab-case)

케밥 케이스는 변수 이름의 각 단어를 소문자로 표기하고, 단어 사이에 하이픈(-)을 사용하는 방식입니다. 이 방식은 HTML, CSS 등 웹 개발에서 주로 사용됩니다. 예를 들어, ‘user-name’이나 ‘total-price’처럼 표기하는 것이 케밥 케이스입니다.

케밥 케이스를 사용하면 단어 사이의 경계를 명확하게 표시할 수 있지만, 일부 프로그래밍 언어에서는 하이픈을 연산자로 인식하기 때문에 사용할 수 없는 경우도 있습니다.

변수 유형에 따른 이름

상수 – 대문자와 언더스코어 사용

상수는 변하지 않는 값을 저장하는 변수로, 대문자와 언더스코어를 사용하여 이름을 지어야 합니다. 이렇게 하면 상수와 일반 변수를 쉽게 구분할 수 있습니다.

예를 들어, ‘MAX_SIZE’, ‘PI’ 등과 같이 표기하는 것이 좋습니다. 상수를 대문자로 표기하는 것은 프로그래밍 언어의 관례이며, 코드를 읽는 사람이 상수임을 쉽게 인지할 수 있도록 합니다.

불린 변수 – “is”, “has” 등의 접두사 사용

불린 변수는 참(true) 또는 거짓(false) 값을 저장하는 변수로, “is”, “has” 등의 접두사를 사용하여 이름을 지어야 합니다. 이렇게 하면 불린 변수임을 쉽게 알 수 있고, 코드의 가독성이 높아집니다.

예를 들어, ‘isValid’, ‘hasChildren’ 등과 같이 표기하는 것이 좋습니다. 불린 변수의 이름은 질문 형태로 표현되기도 하며, 그 결과로 참 또는 거짓이 반환되는 것을 의미합니다.

반복자 – “i”, “j”, “k” 등 간단한 이름 사용

반복자는 반복문에서 사용되는 변수로, 일반적으로 “i”, “j”, “k”와 같은 간단한 이름을 사용합니다. 이렇게 하면 반복자임을 쉽게 알 수 있고, 코드를 간결하게 유지할 수 있습니다.

예를 들어, ‘for (int i = 0; i < length; i++)’와 같이 표기하는 것이 좋습니다. 반복자는 보통 숫자를 저장하며, 반복문 내에서 인덱스 값이나 카운터로 사용됩니다.

프로그래밍 언어별 규칙

파이썬 (Python), 루비 (Ruby)

파이썬에서는 PEP 8이라는 스타일 가이드를 따르는 것이 좋습니다. 이 가이드에 따르면, 변수 이름은 소문자로 시작하는 스네이크 케이스를 사용해야 합니다 (예: ‘variable_name’).

상수는 대문자와 언더스코어를 사용하여 이름을 지어야 합니다 (예: ‘CONSTANT_NAME’). 또한, 클래스 이름은 파스칼 케이스를 사용해야 합니다 (예: ‘ClassName’).

자바 (Java) , 자바스크립트 (JavaScript), C++

자바에서는 변수 이름에 카멜 케이스를 사용하는 것이 좋습니다 (예: ‘variableName’). 상수는 대문자와 언더스코어를 사용하여 이름을 지어야 합니다 (예: ‘CONSTANT_NAME’). 클래스 이름은 파스칼 케이스를 사용해야 합니다 (예: ‘ClassName’).

변수 명 짓기 팁을 알아 두자

변수 명 짓기 팁

이름 길이

변수 이름은 너무 짧지도, 너무 길지도 않아야 합니다. 너무 짧은 이름은 가독성을 해칠 수 있고, 너무 긴 이름은 코드를 복잡하게 만들 수 있습니다. 일반적으로 2-3 단어 정도의 간결한 이름이 좋습니다.

숫자 사용 피하기

변수 이름에 숫자를 사용하는 것은 피해야 합니다. 예를 들어, ‘variable1’, ‘variable2’ 등과 같은 이름은 가독성을 해치고, 코드를 이해하기 어렵게 만듭니다. 대신, 의미를 명확하게 전달하는 이름을 사용하세요.

주의 사항

예약어 사용 금지

프로그래밍 언어에서는 이미 사용되고 있는 예약어를 변수 이름으로 사용할 수 없습니다. 예를 들어, ‘int’, ‘for’, ‘if’ 등은 이미 언어에서 사용되고 있는 키워드이므로, 이러한 단어를 변수 이름으로 사용하는 것은 금지되어 있습니다.

특수 문자 제한

변수 이름에는 알파벳, 숫자, 언더스코어(_)만 사용할 수 있습니다. 하이픈(-), 공백, 기타 특수 문자는 변수 이름으로 사용할 수 없습니다.

추천 학습 자료