C#으로 만든 프로그램이 실행되지 않을 때, 원인은 대개 코드가 아니라 실행 환경 쪽에 있습니다. 닷넷 기반 앱은 빌드 시점의 프레임워크와 실행 PC에 설치된 런타임이 맞아야 구동되며, 이 조합이 어긋나면 "이 앱을 시작할 수 없습니다" 같은 메시지가 뜹니다. 비주얼 C 런타임(Visual C++ Redistributable)은 C#과 별개 계열이지만, 게임·유틸리티 상당수가 함께 요구하기 때문에 실무에서는 두 가지를 한 세트로 챙기는 경우가 많습니다. 아래에서는 무엇을 어떤 순서로 확인하고 설치해야 하는지를 정리합니다.
비주얼 C 런타임과 닷넷 프레임워크는 왜 같이 요구될까
두 이름이 비슷해 보여도 담당하는 영역이 다릅니다. 비주얼 C 런타임은 C++로 작성된 네이티브 코드가 동작하는 데 필요한 라이브러리 묶음이고, 닷넷 프레임워크와 이후의 통합 닷넷 플랫폼은 C# 같은 관리 코드 언어의 실행 기반입니다.
C#은 마이크로소프트가 닷넷 프레임워크 및 비주얼 스튜디오와 함께 도입한 언어로, 2000년 7월에 처음 널리 배포되었고 2002년 ECMA(ECMA-334), 2003년 ISO/IEC 표준으로 승인되었습니다. 설계상 C#은 기초가 되는 공통 언어 기반(CLI)을 가장 직접적으로 반영하는 언어이며, 내장 타입 대부분이 CLI 프레임워크가 구현한 값 타입에 대응합니다.
여기서 실무적으로 중요한 지점이 하나 있습니다. C# 언어 사양은 컴파일러가 반드시 공통 언어 런타임(CLR)을 대상으로 하거나 공통 중간 언어(CIL)를 생성하라고 규정하지 않습니다. 일부 C# 컴파일러는 기계어를 직접 생성할 수도 있습니다. 즉 "C#으로 만들었으니 무조건 닷넷 런타임이 필요하다"고 단정할 수는 없고, 배포 형태에 따라 필요한 구성 요소가 달라집니다.
닷넷 진영 자체도 하나로 고정되어 있지 않습니다. 2004년에는 C# 언어를 위한 교차 플랫폼 컴파일러와 런타임 환경을 제공하는 모노(Mono) 프로젝트가 시작되었고, 그로부터 10년 후 마이크로소프트는 비주얼 스튜디오 코드, Roslyn 컴파일러, 통합 닷넷 플랫폼을 출시했습니다. 이들은 모두 C#을 지원하고 무료이며 오픈 소스인 교차 플랫폼입니다. 모노 또한 마이크로소프트에 합류했으나 닷넷으로 통합되지는 않았습니다.
| 구분 | 성격 | 비고 |
|---|---|---|
| 비주얼 C 런타임 | 네이티브 C++ 라이브러리 | 앱과 함께 요구되는 경우 많음 |
| 닷넷 프레임워크 | Windows 전용 실행 기반 | 비주얼 스튜디오와 함께 도입 |
| 통합 닷넷 플랫폼 | 무료·오픈 소스 교차 플랫폼 | 모노와는 별개로 유지 |
내 PC에 무엇이 빠졌는지 먼저 확인하는 방법
무작정 여러 버전을 설치하기 전에, 실행하려는 프로그램이 요구하는 대상부터 확인하는 편이 빠릅니다. 프로그램 제작사가 배포 페이지에 요구 사항을 명시하는 경우가 대부분이므로, 설치 안내 문구에 적힌 프레임워크 버전과 비트 수(32비트/64비트)를 그대로 확인하면 됩니다.
C#이 어떤 실행 환경을 대상으로 빌드되었는지는 언어 차원에서 강제되지 않는다는 점도 감안해야 합니다. 앞서 언급했듯 컴파일러가 CLR을 대상으로 하지 않을 수도 있기 때문에, 오류 메시지에 표시된 런타임 이름을 기준으로 판단하는 것이 안전합니다.
확인 순서는 다음과 같습니다.
- 실행하려는 프로그램의 공식 배포 페이지에서 요구 사항 문구를 확인합니다.
- 오류 대화상자나 로그에 표시된 런타임 이름과 버전을 기록합니다.
- 운영체제 비트 수와 프로그램 비트 수가 일치하는지 확인합니다.
- 이미 설치된 런타임 목록과 대조해 빠진 항목만 추립니다.
- 한 번에 여러 버전을 지우지 말고, 빠진 것만 추가 설치합니다.
설치보다 먼저 봐야 할 빌드 구성 디버그와 릴리스
개발 중이라면 실행 오류의 원인이 런타임 누락이 아니라 빌드 구성일 수 있습니다. 비주얼 스튜디오의 빌드 구성에는 디버그와 릴리스라는 두 가지 기본 형식이 있습니다.
디버그 구성은 더 풍부한 대화형 런타임 디버깅 환경을 허용하는 대신 더 느리고 더 큰 실행 파일을 생성합니다. 디버그 실행 파일은 배송되어서는 안 됩니다. 반면 릴리스 구성은 배송에 적합한 더 빠르고 최적화된 실행 파일을 빌드합니다. 기본 빌드 구성은 디버그입니다.
즉 개발 PC에서는 잘 돌아가던 프로그램이 다른 PC에서 실패한다면, 릴리스로 다시 빌드했는지부터 확인할 가치가 있습니다.
| 구성 | 실행 속도 | 배포 적합성 |
|---|---|---|
| 디버그 | 느림 | 부적합 |
| 릴리스 | 빠름, 최적화 | 적합 |
빌드 자체는 비주얼 스튜디오에서 F7 키를 누르는 것이 가장 쉬운 방법이며, 주 메뉴에서 빌드 > 솔루션 빌드를 선택해도 됩니다. 사용자 인터페이스 맨 아래에 있는 출력 창에서 빌드 프로세스를 관찰할 수 있고, 오류, 경고 및 빌드 작업이 여기에 표시됩니다. 오류가 있거나 구성된 수준 이상의 경고가 있는 경우 빌드가 실패합니다.
빌드는 성공했는데 실행이 안 될 때 확인할 항목
빌드가 통과했다는 사실은 실행 환경이 준비되었다는 뜻이 아닙니다. 컴파일 성공과 런타임 구동은 별개 단계이기 때문입니다.
비주얼 스튜디오에는 입력할 때 C# 및 Visual Basic 코드를 검사하는 기본 제공 닷넷 컴파일러 플랫폼 분석기 세트가 포함되어 있습니다. 규칙 위반이 발견되면 오류 목록에 나타나며 코드 편집기에서 잘못된 코드 아래에 물결선으로 표시됩니다. 이 경고들은 빌드를 막지는 않지만, 실행 단계에서 문제로 드러날 수 있습니다.
빌드 출력 창의 아래쪽으로 이동하여 오류 목록 탭을 선택하면 프로젝트에 대한 오류 및 경고를 체계적으로 볼 수 있습니다. 오류 목록 창의 오류 줄을 선택하면 오류가 발생한 줄로 이동하며, Ctrl+G를 눌러 오류가 발생한 줄 번호로 빠르게 이동할 수도 있습니다.
문제를 더 세부적으로 보려면 다음 경로를 활용합니다.
- 출력 창에서 원시 컴파일러 출력과 오류 메시지를 확인합니다.
- 오류 목록 창에서 정렬·필터링 가능한 목록을 확인합니다.
- 오류 줄을 마우스 오른쪽 단추로 클릭해 오류 도움말 표시를 선택합니다.
- 필요하면 오류 코드 값에 대한 하이퍼링크를 따라 상세 내용을 봅니다.
- 수정 후 F7 또는 Ctrl+Alt+F7로 다시 빌드합니다.
런타임 설치 후에도 남는 문제를 다루는 순서
런타임을 설치했는데도 증상이 그대로라면 원인은 대개 세 갈래로 나뉩니다. 비트 수 불일치, 관리 코드와 네이티브 코드의 혼합, 그리고 코드 자체의 런타임 오류입니다.
C#은 타입 시스템이 값 타입과 참조 타입 두 계열로 나뉘고, C++보다 타입 안전성이 높습니다. 기본적으로 허용되는 유일한 암시적 변환은 정수 범위 확장처럼 안전하다고 간주되는 것뿐이며, 이는 컴파일 시점, Just-in-time 컴파일 중, 그리고 일부 경우 실행 시점에 강제됩니다. 이런 특성 때문에 컴파일은 통과해도 실행 시점에 형 변환 문제가 드러나는 경우가 있습니다.
또한 C#은 전역 변수나 함수를 허용하지 않고 모든 메서드와 멤버가 클래스 내부에 선언되어야 하며, 지역 변수는 자신을 감싸는 블록의 변수를 가릴 수 없습니다. 이런 규칙 위반은 대부분 컴파일 단계에서 걸러지지만, 동적 바인딩을 사용하는 경우에는 실행 시점까지 드러나지 않을 수 있습니다.
정리하면 다음 순서로 좁혀가는 것이 효율적입니다.
- 프로그램과 운영체제의 비트 수가 일치하는지 다시 확인합니다.
- 네이티브 구성 요소가 섞여 있다면 비주얼 C 런타임도 함께 점검합니다.
- 릴리스 구성으로 다시 빌드해 결과가 달라지는지 확인합니다.
- 오류 목록의 경고를 모두 해소한 뒤 재실행합니다.
- 그래도 남으면 오류 코드 값을 기준으로 원인을 검색합니다.
자주 나오는 질문
Q. 닷넷 프레임워크와 통합 닷넷 플랫폼 중 무엇을 설치해야 하나요?
실행하려는 프로그램의 요구 사항 문구가 기준입니다. 통합 닷넷 플랫폼은 무료이며 오픈 소스인 교차 플랫폼이고, 닷넷 프레임워크는 비주얼 스튜디오와 함께 도입된 Windows 중심 기반입니다. 둘은 대체 관계가 아니므로 요구 사항에 적힌 쪽을 설치하는 것이 맞습니다.
Q. 비주얼 C 런타임은 C# 프로그램에도 필요한가요?
C#은 관리 코드 언어이고 비주얼 C 런타임은 네이티브 C++ 계열 라이브러리라 용도가 다릅니다. 다만 하나의 프로그램이 두 요소를 함께 사용하는 경우가 있어, 오류 메시지에 어떤 런타임 이름이 찍히는지를 기준으로 판단해야 합니다.
Q. 디버그로 빌드한 파일을 그대로 배포하면 안 되나요?
디버그 실행 파일은 배송되어서는 안 된다고 명시되어 있습니다. 더 느리고 더 큰 실행 파일이 생성되며, 배포에는 릴리스 구성이 적합합니다.
Q. C#인데 꼭 닷넷 런타임이 있어야 하나요?
반드시 그렇지는 않습니다. C# 언어 사양은 컴파일러가 CLR을 대상으로 하거나 CIL을 생성하도록 규정하지 않으며, 일부 컴파일러는 기계어를 생성할 수도 있습니다. 배포 형태에 따라 달라집니다.
Q. 오류 코드만으로 원인을 알 수 있나요?
오류 목록 창에서 오류나 경고에 대한 자세한 내용은 자동 Bing 검색을 수행할 수 있고, 오류 코드 값에 대한 하이퍼링크를 따라갈 수도 있습니다. 다만 검색 결과는 인터넷의 여러 다른 원본에서 생성되므로 모든 것이 유용하지는 않을 수 있습니다.