변수 이름 잘 짓는 법, 나중에 후회 안 하려면 꼭 알아야 할 팁

변수 이름, 그냥 작명이라고 생각했는데… 진짜 중요하더라고요

처음 코딩할 때는요, 변수 이름 아무렇게나 지었어요. 뭐, x, data, temp 이런 거요. 근데 나중에 제 코드 다시 열어보니까, "이게 뭐였더라...?" 하고 한참 멍하니 바라본 적이 한두 번이 아니에요. 그때 깨달았죠. 아, 이거 그냥 이름 문제가 아니라, 코드 읽는 사람이랑 대화하는 문제구나.

오늘은 제가 느낀 거, 그리고 해보니까 진짜 도움 됐던 변수 이름 짓는 팁들을 좀 편하게 나눠볼게요. 실무에서도, 사이드 프로젝트에서도 다 써먹을 수 있으니까요.

 

---

 

옛날 내 코드 열어보면 미궁 탐험 시작됨

 

옛날 내 코드 열어보면 미궁 탐험 시작됨

한 달쯤 지난 프로젝트 파일 열었는데 tmp, x, val 이런 게 우르르… 와, 이게 무슨 데이터였는지 도무지 감이 안 오더라고요. 예전엔 그런 이름이 깔끔해 보였는데, 지금 보면 진짜 내가 왜 그랬을까 싶어요.

이름만 좀 신경 썼어도 그때 그 디버깅 시간 줄였을 텐데 말이죠. 앞으로는 내 코드가 내가 봐도 친절하게 느껴졌으면 좋겠더라고요.

• 의미 없는 변수 이름 때문에 나중에 코드 이해가 어려움
• 디버깅 시간 낭비를 줄이려면 이름부터 신경 써야 함
• 내 코드가 나에게도 친절하게 느껴져야 함

 

---

 

✅ 이름만 봐도 뭐 하는지 알 수 있게!

 

✅ 이름만 봐도 뭐 하는지 알 수 있게!

x = 37 이거랑 celsius_temperature = 37 이거랑 느낌 완전 다르죠?

후자는 딱 보면 아, 섭씨 온도구나 하고 감이 와요. 그런데 앞의 x는 뭐지? 좌표? 점수? 뭐에 쓰는지 하나도 안 보여요.

그리고 반복문에서 i, j 이런 거 대신에 index, product_counter처럼 조금만 길게 쓰면, 누가 봐도 무슨 뜻인지 쉽게 와닿아요. 별 거 아닌 것 같지만, 진짜 체감돼요.

• 변수 이름은 의미를 담고 있어야 직관적으로 이해 가능함
• 반복문에서도 의미 있는 이름을 쓰면 가독성이 높아짐

 

---

 

❌ 흔한 이름은 정보가 없어요

value, data, info 이런 이름... 너무 자주 보이는데, 그만큼 너무 모호하죠. '어떤 값인데?' 싶은 거예요.

대신에 total_purchases 같은 이름을 쓰면, 아 구매 총합이구나 하고 바로 이해되잖아요.

그리고 진짜 조심할 거! tmp라는 이름. 쓰고 나서 안 지우고 계속 쓰게 되거든요. 나중엔 무슨 임시인지 아무도 몰라요. 그냥 처음부터 제대로 지으면 속 편해요.

• value, data 같은 이름은 너무 추상적이라 의미 전달이 어려움
• 가능한 한 구체적인 변수명을 사용해 맥락을 명확히 해야 함
• tmp 같은 이름은 지속적으로 쓰이게 되면 혼란을 유발함

 

---

 

🧠 이름이 좀 길어도 괜찮아요. 너무 걱정 마세요!

솔직히 변수 이름 긴 게 무서웠거든요. 근데 요즘은 IDE가 알아서 자동완성해주니까 별로 불편한 것도 없어요.

길더라도 직관적인 게 훨씬 좋아요. 물론 total_user_purchase_amount_in_dollars 이런 건 좀 과하지만, purchase_amount_dollar 정도는 충분히 쓸만하죠.

줄임말도 무턱대고 하지 말고, 발음 가능한 형태로 해줘야 나중에 보기 편해요. 그리고 어디선 줄이고, 어디선 안 줄이면 더 헷갈려요. 통일감 있게 가는 게 좋아요.

• IDE 자동완성 기능 덕분에 긴 변수 이름도 불편하지 않음
• 긴 이름이라도 의미가 명확하면 오히려 효율적임
• 줄임말은 발음 가능한 형태로, 일관성 있게 사용하는 게 좋음

 

---

 

📍 변수는 쓸 때 근처에서 선언하자

 

📍 변수는 쓸 때 근처에서 선언하자

예전엔 습관처럼 파일 맨 위에 다 써놨는데, 요즘은 그게 오히려 읽기 불편하더라고요. 변수 선언은 실제로 쓰는 바로 근처에 하는 게 훨씬 자연스럽고요.

for product in products:
    discounted_price = get_discount(product)

 

이런 식이면 코드 흐름도 부드럽고, 선언이랑 사용이 붙어 있어서 보기도 편해요. 쓸데없이 위에서 선언했다가 나중에 다시 찾아가고... 시간 낭비예요.

• 변수는 실제로 사용하는 위치 근처에서 선언하는 게 가독성과 유지보수에 유리함
• 선언과 사용이 가까우면 흐름이 자연스럽고 이해하기 쉬움

 

---

 

⏱️ 시간 단위는 이름에 꼭 넣자

duration = 120 이렇게만 써놓으면, 이게 초인지, 분인지, 시간인지 헷갈려요.

time_since_post_sec = 120

 

이렇게 단위를 명확하게 붙이면, 오해할 일도 없고, 나중에 실수할 일도 줄어요. 진짜 작은 차이가 큰 사고를 막는다는 말, 변수 이름에도 적용돼요.

• 시간이나 단위가 있는 값은 변수 이름에 단위를 포함시키는 것이 좋음
• 단위를 명시함으로써 오해나 실수를 줄일 수 있음

 

---

 

🤔 Boolean은 질문처럼, 그리고 긍정형으로!

Boolean 변수는 예/아니오로 답할 수 있어야 해요. 그래서 is_admin, has_purchased, can_edit_profile 이런 이름이 좋아요.

그리고 되도록이면 긍정형으로 쓰는 게 이해하기 더 쉬워요. is_not_admin보단 is_admin이 읽는 데 훨씬 편하죠.

조건문이 마치 말처럼 자연스럽게 읽히면, 코드 보는 스트레스가 정말 줄어들어요. 말 그대로 눈에 쏙 들어오는 느낌!

• Boolean 변수는 질문형으로 만들면 가독성이 좋아짐
• 긍정형 표현이 부정형보다 이해하기 쉽고 자연스러움
• 조건문이 자연스럽게 읽히면 코드 흐름 파악이 쉬움

 

---

 

🙋‍♀️ 결국, 변수 이름 잘 짓는 건 서로를 위한 배려예요

정말요. 그냥 예쁘게 꾸미자는 게 아니에요. 변수 이름 하나에도 그 코드를 보는 사람을 배려하는 마음이 담길 수 있어요. 미래의 나도 포함해서요.

 

"프로그램은 사람이 읽을 수 있게 써야 한다. 기계가 이해하는 건 그 다음이다." — Harold Abelson

 

이 말, 진짜 백 번 공감해요. 나중에라도 내 코드가 누군가에게 편하게 읽힌다면, 그게 바로 좋은 코드 아닐까요?

• 변수 이름 하나에도 읽는 사람을 위한 배려가 담길 수 있음
• 나중의 나 혹은 다른 사람을 위해 친절한 코드를 작성하는 습관 필요
• 명확한 작명은 협업뿐 아니라 나 자신에게도 도움이 됨

 

---

 

검색어 같은 건 참고로...

• 변수 이름 어떻게 잘 지을까?
• Python 변수 작명 꿀팁
• 읽기 쉬운 코드 만드는 방법
• 헷갈리지 않는 변수 이름
• 명확한 변수 작명 스타일
• Boolean 변수 이름 팁

 

다음에 변수 하나라도 이름 지을 때, 3초만 더 고민해보세요. 그게 누군가에겐 (아마도 나 자신?) 몇 시간 아낄 수 있는 선물이 될지도 몰라요!