상담 신청
홈 › 작업 노트 › 개발 › 스크립트 이름과 변수 이름 규칙 점검

개발 · 점검 노트

스크립트 이름과 변수 이름 규칙 점검

Assets 폴더에 NewBehaviourScript, Test2, PlayerFinal_real 같은 파일이 쌓여 있다면 이름 점검을 할 때입니다. 이름은 코드를 다시 읽는 나와 함께 작업하는 팀원에게 주는 첫 번째 설명서입니다. 아래 항목을 프로젝트를 열어 둔 채 하나씩 대조해 보세요.

작업 노트 481 · 읽는 시간 약 5분 · 2026.11.17 정리

파일 이름과 클래스 이름이 같은지부터 확인

유니티에서 게임오브젝트에 붙이는 스크립트는 파일 이름과 그 안의 클래스 이름이 같아야 합니다. 프로젝트 창에서 파일 이름만 바꾸고 코드 안의 클래스 이름은 그대로 두면, 컴포넌트를 붙일 때 스크립트를 불러올 수 없다는 경고가 뜨거나 이미 붙어 있던 컴포넌트가 빈칸으로 바뀝니다.

점검은 간단합니다. 스크립트 폴더를 열고 파일을 하나씩 더블클릭해 class 뒤에 적힌 이름이 파일 이름과 글자 하나까지 같은지 봅니다. 대소문자도 구분하므로 playerMove와 PlayerMove는 다른 이름입니다. 맞지 않는 파일을 발견하면 어느 쪽을 기준으로 맞출지 먼저 정합니다. 이름이 비슷한 파일이 많다면 목록을 메모장에 옮겨 적고 확인한 것에 표시하며 진행하면 빠뜨리지 않습니다.

고칠 때는 코드 편집기에서 클래스 이름을 바꾼 다음, 유니티 프로젝트 창에서 파일 이름을 같은 이름으로 바꿉니다. 두 작업 사이에 다른 것을 건드리지 않아야 연결이 끊기지 않습니다. 고친 뒤에는 그 스크립트를 쓰는 씬과 프리팹을 열어 컴포넌트가 제대로 남아 있는지 꼭 눈으로 확인합니다.

이름만 보고 하는 일을 짐작할 수 있는가

두 번째 항목은 이름의 뜻입니다. Manager, Controller, Script처럼 넓은 단어만 붙은 이름은 시간이 지나면 무엇이든 담는 상자가 됩니다. GameManager 하나에 점수, 사운드, 씬 전환, 저장이 모두 들어 있다면 이름이 역할을 설명하지 못하는 상태입니다.

확인 방법은 파일 이름을 소리 내어 읽고 그 스크립트가 하는 일을 한 문장으로 말해 보는 것입니다. PlayerHealth라면 체력을 깎고 회복하는 일, EnemySpawner라면 적을 만들어 내는 일이 바로 떠오릅니다. 한 문장에 그리고가 두 번 이상 들어가면 스크립트를 나눌 후보로 표시해 둡니다.

Test, New, Temp, Final 같은 단어가 붙은 파일은 정리 대상입니다. 실제로 쓰이는지 찾아보고, 쓰이지 않으면 별도 폴더로 옮겨 두었다가 며칠 동안 문제가 없을 때 지웁니다. 쓰이고 있다면 역할에 맞는 이름으로 바꾸고, 위에서 설명한 순서대로 파일 이름도 함께 맞춥니다.

유니티 수업에서 다루는 작업 예시
유니티 수업에서 다루는 작업 예시

변수와 함수 이름의 표기 방식이 한 가지로 통일됐는가

C#에서 흔히 쓰는 방식은 클래스와 함수 이름을 대문자로 시작하고 단어마다 첫 글자를 대문자로 쓰는 것, 변수는 소문자로 시작하는 것입니다. 중요한 것은 어느 방식을 고르든 한 프로젝트 안에서 섞지 않는 것입니다. 팀이라면 첫 주에 규칙을 한 장으로 적어 공유합니다.

  • 클래스·함수: PlayerMove, TakeDamage처럼 대문자로 시작하는지
  • 지역 변수·매개변수: moveSpeed, damage처럼 소문자로 시작하는지
  • private 필드에 밑줄 같은 접두어를 쓰기로 했다면 모든 파일에 똑같이 붙었는지
  • 참·거짓 값은 isGrounded, canJump처럼 질문 형태로 읽히는지

줄임말도 점검합니다. spd, hp, dmg처럼 줄이면 타이핑은 빠르지만, 다른 사람은 뜻을 추측해야 합니다. 체력처럼 누구나 아는 말 몇 개만 허용 목록으로 정하고 나머지는 풀어 씁니다. 한 글자 변수 이름은 반복문의 i처럼 범위가 아주 짧은 곳에서만 씁니다. 허용 목록은 규칙 문서 맨 아래에 적어 두고, 새 줄임말이 필요해지면 팀원과 합의한 뒤에만 추가합니다.

인스펙터에 노출된 변수 이름을 바꿀 때 조심할 점

public으로 선언했거나 SerializeField 속성을 붙인 변수는 인스펙터에 나타나고, 거기 입력한 값은 씬과 프리팹에 저장됩니다. 이 변수 이름을 코드에서 바꾸면 유니티는 다른 변수로 인식해 이전에 넣어 둔 값이 기본값으로 돌아갑니다. 이름 정리를 하다가 몇 시간 조정한 수치가 사라지는 일이 여기서 생깁니다.

이를 막는 방법은 두 가지입니다. 하나는 바꾸기 전에 인스펙터 값을 메모해 두고 바꾼 뒤 다시 입력하는 것입니다. 다른 하나는 FormerlySerializedAs 속성을 새 이름 위에 붙여 예전 이름을 알려 주는 것인데, 값이 옮겨진 것을 확인하고 씬을 저장한 뒤에 정리합니다.

인스펙터에서 보이는 이름도 함께 봅니다. 유니티는 moveSpeed 같은 변수를 Move Speed처럼 띄어 써서 보여 주므로, 코드 이름이 어색하면 화면에서도 어색합니다. 기획자나 아티스트가 수치를 만지는 변수라면, 그 사람이 읽고 바로 뜻을 알 수 있는 이름인지 따로 확인합니다. 툴팁 속성으로 짧은 설명을 붙여 두면 마우스를 올렸을 때 뜻을 확인할 수 있어 수치 조정 실수가 줄어듭니다.

유니티 과정 실습 장면 예시
유니티 과정 실습 장면 예시

점검 결과를 남기고 다음 작업에 반영하는 법

점검을 마치면 바꾼 이름을 이전 이름과 나란히 적은 짧은 목록을 남깁니다. 팀원이 오래된 코드를 보다가 이름이 달라 헷갈릴 때 바로 찾을 수 있고, 깃 같은 버전 관리 도구를 쓴다면 이름 변경만 따로 모아 한 번에 기록해 두는 편이 나중에 추적하기 쉽습니다.

규칙 문서는 길 필요가 없습니다. 파일 이름, 함수 이름, 변수 이름, 줄임말 허용 목록 네 줄이면 충분합니다. 새 스크립트를 만들 때마다 이 네 줄을 떠올리면 다음 점검은 훨씬 짧아집니다. 포트폴리오로 코드를 공개할 계획이라면 제출 전에 한 번 더 같은 순서로 훑어봅니다.

SBS아카데미게임학원 유니티 과정에서는 C# 문법을 익힌 뒤 게임 오브젝트와 씬을 다루며 기능을 붙여 나가기 때문에, 이름을 짓는 습관이 프로젝트 후반까지 이어집니다. 지금 만든 프로젝트 구조가 이대로 괜찮은지 판단이 어렵다면 무료 상담에서 코드를 보여 주고 시작 단계를 함께 정해 보세요.

자주 묻는 질문

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

C#은 한글 식별자를 허용하지만, 협업과 검색, 다른 도구와의 호환을 생각하면 영어로 쓰는 편이 무난합니다. 대신 주석은 한글로 달아도 괜찮습니다.

이름 규칙은 누가 정하나요?

회사나 팀마다 자체 규칙이 있는 경우가 많고, 신입은 그 문서를 먼저 받습니다. 개인 프로젝트라면 스스로 정한 규칙을 끝까지 지키는 것이 중요합니다.

유니티 수업 예시
이 글과 이어지는 과정유니티 과정 안내

수업 순서, 목표별 결과물, 가까운 센터를 한 페이지에서 볼 수 있습니다.

과정 보기 →

함께 읽으면 좋은 노트

무료 상담 신청

읽은 글과 관련해 궁금한 점이나 지금 상황을 남기면 담당자가 연락드립니다.

상담·컨설팅 무료 · 전화 상담 010-2135-9730

전화상담 신청