명명 스크립트
컴파일러가 클래스를 식별하는 데 도움이 되는 스크립트의 이름을 지정합니다. 네임스페이스 사용하여 논리적으로 스크립트를 구성하고 클래스명 충돌을 방지합니다.
읽는 시간 3분최근 업데이트: 9일 전
스크립트 파일의 이름과 그 안에 선언된 클래스를 신중하게 선택해야 합니다. 적절한 파일 이름을 사용하고 네임스페이스 아래에 클래스를 정리하면 컴파일러가 오류 없이 클래스를 식별할 수 있습니다.
스크립트 파일 이름
스크립트를 생성할 때 입력하는 파일 이름은 그 안에 정의된 클래스의 이름에도 사용됩니다. 스크립트의 파일 이름을 그 안에 정의된 클래스의 이름과 일치시키는 것이 좋습니다.
빌트인 Unity 타입 및 에서 파생된 스크립트의 경우 파일 이름이 일치하지 않더라도 Unity는 스크립트에 정의된 클래스 타입을 확인할 수 있지만 다음과 같은 제한 사항이 있습니다.
MonoBehaviourScriptableObject- 스크립트에 여러 클래스가 정의된 경우 Unity 파일과 동일한 이름의 클래스를 선택합니다.
- C# 키워드를 사용하여 여러 파일에 걸쳐 하나의 MonoBehaviour 파생 클래스를 정의하는 경우
partial클래스와 동일한 이름의 파일만 컴포넌트로 사용할 수 있습니다.partial
클래스명 및 네임스페이스
명명 충돌은 프로젝트의 다른 부분에서 동일한 이름의 여러 클래스를 선언할 때 발생합니다. 명명 충돌의 가능성은 프로젝트의 규모와 기여자 수에 따라 증가합니다. 예를 들어 한 개발자는 메인 플레이어 캐릭터를 제어하는 코드를 작성하는 반면, 다른 개발자는 적을 위한 동등한 코드를 작성할 수 있습니다. 두 개발자가 메인 클래스 를 호출하도록 선택하면 컴파일러는 코드에서 어떤 클래스의 사용을 참조할 수 없게 됩니다.
ControllerController클래스명 충돌을 방지하기 위해 C# 프로그래밍에서는 네임스페이스 클래스를 정리하는 것이 좋습니다. 네임스페이스는 클래스의 컬렉션이며, 클래스 이름에 접두사가 붙은 네임스페이스는 클래스를 참조하는 완전하고 명확한 방법을 제공합니다. 자세한 내용은 Microsoft의 네임스페이스 기술 자료를 참고하십시오.
아래 예시에서 클래스 및 는 라는 네임스페이스의 구성원입니다.
Controller1Controller2Enemy네임스페이스 적 { public class Controller1 : MonoBehaviour { ... } public class Controller2 : MonoBehaviour { ... }}
전체 이름을 사용하여 이러한 클래스를 코드에서 명확하게 참조할 수 있습니다. 전체 이름은 네임스페이스와 클래스명, 이 경우 각각 및 입니다. 기존 클래스 선언 주변에 네임스페이스 선언을 추가하여 모든 클래스의 이름을 개별적으로 변경할 필요가 없습니다. 클래스가 다른 소스 파일에 있더라도 클래스가 발생하는 모든 위치에 네임스페이스 선언을 추가할 수 있습니다.
Enemy.Controller1Enemy.Controller2파일 상단에 지시문을 추가하여 네임스페이스 접두사를 반복적으로 입력하지 않아도 됩니다.
usingusing Enemy;
이렇게 하면 컴파일러가 이 파일에서 및 에 대한 레퍼런스를 각각 및 로 확인합니다. 스크립트에서 다른 네임스페이스(예: )에서 동일한 이름의 클래스를 참조해야 하는 경우 네임스페이스 접두사를 지정해야 합니다. 충돌하는 클래스명이 포함된 네임스페이스 두 개가 같은 파일에 있는 지시문과 함께 임포트되면 컴파일러가 오류를 보고합니다.
Controller1Controller2Enemy.Controller1Enemy.Controller2Playerusing여러 네임스페이스 대한 제한
Unity 네임스페이스 MonoBehaviour 또는 ScriptableObject 클래스와 관련된 특정 제한이 있습니다. 파일에 MonoBehaviour 또는 ScriptableObject 클래스에 대한 정의가 포함된 경우 해당 파일 내에서 여러 네임스페이스 사용할 수 없습니다.
Unity 콘솔에 다음과 같은 경고를 표시합니다.
MyClass 클래스는 동일한 파일의 여러 네임스페이스 존재할 수 없으며, 하나는 프리 프로세서 지시문으로 제외됩니다. 이 경우 파일을 별도의 파일로 이동하세요.
하나의 네임스페이스에 MonoBehaviour를 정의하는 파일과 같은 파일 내 다른 네임스페이스에 있는 다른 클래스가 있는 경우 Unity는 MonoBehaviour 클래스를 인식하지 못하고 게임 오브젝트에서 사용할 수 없습니다. 이 제한은 Unity 2020.1에서 임포트 및 컴파일 속도를 높이기 위해 도입되었기 때문에 이 제한이 도입되기 전에 작성된 일부 구형 에셋 스토어 패키지는 그 결과 잘못 작동할 수 있습니다. 이 문제와 관련된 문제를 수정하려면 각 네임스페이스의 클래스에 대한 코드를 분리하여 파일을 분리하십시오.