형식 또는 네임스페이스 이름을 찾을 수 없습니다. using 지시문 또는 어셈블리 참조가 있는지 확인하십시오
C#에서 '형식 또는 네임스페이스 이름을 찾을 수 없습니다. using 지시문 또는 어셈블리 참조가 있는지 확인하십시오'와 함께 발생하는 오류코드는 CS0246입니다. 이번 주제는 해당 오류를 해결하는 방법에 대해 알아보도록 합시다.
형식 또는 네임스페이스 이름을 찾을 수 없을 때에는 시작 프로젝트의 참조에서 노란색 경고 표시가 있는 참조를 확인하거나 오류 목록에 있는 네임스페이스를 확인합니다.
1. 외부 참조가 누락되어 있는 경우에는 [프로젝트] 또는 참조 부분에서 우클릭 이후 [참조]를 눌러 참조 관리자를 실행해 주세요. 어셈블리, 프로젝트, COM 중 누락된 참조를 추가하여 빌드를 진행합니다.
2. 솔루션 또는 프로젝트 리빌드에 의해 출력 경로 상의 참조가 정리되어 버리는 경우가 있습니다. 이것 또한 위와 마찬가지로 누락된 참조를 제 자리에 위치하도록 진행해 주세요.
이것으로 CS0246 오류를 해결할 수 있습니다.
참조가 정상, 문제가 없는데도 발생하는 경우
새로운 피씨에서 설정을 하다보니, 모든 참조가 정상적으로 되어 있는데도, '형식 또는 네임스페이스 이름을 찾을 수 없습니다. using 지시문 또는 어셈블리 참조가 있는지 확인하세요' 오류가 발생하더라고요. 프레임워크를 수정하며 확인한 결과, 높은 윈도우 버전에서 최초 빌드 시 낮은 프레임워크를 사용하는 경우에 문제가 발생하는 것으로 보입니다.
새 PC에서 빌드가 안 될 때, 윈도우 11 프로 기준으로 점검할 수 있는 사항을 아래와 같이 정리해보았습니다.
백신 프로그램 예외 확인
- 백신 프로그램이 빌드 프로세스를 방해할 수 있습니다. 백신 프로그램의 실시간 보호 또는 방화벽 설정에서 개발 환경(예: Visual Studio, 빌드 디렉토리)을 예외로 추가해 보세요. 특히 McAfee 같이 일정 기간 무료로 제공이 되는 백신을 점검해 보세요.
윈도우즈 업데이트 최신 확인
- 최신 윈도우 업데이트가 설치되어 있는지 확인합니다. 특히 개발 도구나 빌드 환경과 관련된 업데이트가 누락된 경우 문제가 발생할 수 있습니다.
설정 > Windows 업데이트에서 최신 상태를 확인합니다.
Windows 기능 켜기/끄기에서 .NET Framework 3.5 사용 여부 확인
- .NET Framework 3.5는 Windows 10 이상에서는 기본적으로 비활성화되어 있을 수 있습니다.
제어판 > 프로그램 및 기능 > Windows 기능 켜기/끄기에서.NET Framework 3.5가 활성화되어 있는지 확인합니다. 체크가 풀려있다면 선택하고 확인해 주세요. 닷넷 프레임워크 3.5를 설치하기 위해 다소의 시간이 필요할 수 있어요.
Visual Studio Installer에서 .NET Framework 3.5 개발 도구 설치 확인
- Visual Studio를 사용하는 경우, Visual Studio Installer에서
.NET Framework 3.5 개발 도구가 설치되어 있는지 확인하고, 설치가 되어 있지 않다면 체크하여 추가 설치합니다. 기본값으로 체크가 되어 있지 않기에 필요 시 추가적으로 신경써야 하는 부분입니다.
Visual Studio Installer > 개별 구성 요소 >.NET>.NET Framework 3.5 개발 도구체크 후 설치.
참조 점검
- 솔루션 내 각 프로젝트의 참조가 올바른지 다시 확인합니다. 특히 새 시스템에서는 종종 라이브러리 참조가 올바르게 설정되지 않을 수 있습니다.
참조가 올바르지 않으면 '참조 추가'에서 누락된 참조를 추가하세요. 정상적인 프로젝트로 보이더라도 문제가 되는 경우가 있습니다., 한 번 언로드 하였다가 다시 로드하여 정상적으로 실행되는지 지켜봅시다.
프로젝트 전체 언로드 후 종속성 기준으로 빌드 확인
- 솔루션 내 프로젝트를 하나씩 언로드하고, 빌드 순서가 맞는지 확인합니다. 종속성을 기준으로 빌드 순서를 확인하는 것이 중요합니다.
예를 들어, 종속성이 있는 프로젝트부터 차례대로 빌드를 시도하며 문제를 해결해 보세요.
가장 기본이 되는 프로젝트부터 빌드를 시작하면 빌드 오류를 더 쉽게 파악할 수 있습니다. 빌드 오류를 스택 형태로 보여주는 경우가 있으니, 오류가 많이 발생한 경우 가장 아래쪽에 있는 오류 메시지부터 다시 점검해 보세요.
필요 시 재빌드 등 추가 점검
- 일부 프로젝트는 간단히 빌드만 하는 것으로는 해결되지 않을 수 있습니다. 필요할 경우 리빌드(Rebuild) 또는 정리(Clean)를 시도해 보세요.
위 사항을 순차적으로 점검하면서 문제를 해결해 나가면 새 PC 환경에서 빌드 오류를 상당 부분 해결할 수 있을 것입니다. 우여곡절 끝에 겨우 해결하여 기록을 남깁니다. 😉