# MinGW (Minimalist GNU for Windows)

## 1. 개요
**MinGW(Minimalist GNU for Windows)**는 Windows 운영체제 환경에서 GNU 컴파일러 컬렉션(GCC, GNU Compiler Collection)을 사용할 수 있도록 제공하는 오픈 소스 개발 도구체인이다. GCC는 리눅스와 같은 유닉스 계열 시스템의 표준 컴파일러로, MinGW는 이를 Windows 플랫폼으로 포팅하여 사용자가 별도의 유닉스 에뮬레이션 레이어 없이 Windows 네이티브 바이너리를 생성할 수 있게 하는 것을 목적으로 한다.

현재는 64비트 아키텍처와 최신 언어 표준을 지원하는 **MinGW-w64** 프로젝트가 사실상의 표준(de facto standard)으로 사용되고 있다.

## 2. 주요 특징 및 작동 원리
MinGW의 핵심은 Windows의 표준 C 런타임 라이브러리를 직접 사용한다는 점이다. 이로 인해 MinGW로 컴파일된 프로그램은 실행 시 별도의 무거운 호환성 레이어가 필요 없으며, Windows OS에서 직접 실행되는 네이티브 애플리케이션이 된다.

이는 유닉스 환경을 Windows에서 흉내 내는 Cygwin과 결정적인 차이점이다. Cygwin은 POSIX(Portable Operating System Interface) 호환성을 위해 `cygwin1.dll`이라는 중간 계층을 사용하지만, MinGW는 Windows API를 직접 호출한다.

### [표] MinGW vs Cygwin vs MSVC 비교

| 구분 | MinGW | Cygwin | MSVC (Visual Studio) |
| :--- | :--- | :--- | :--- |
| **컴파일러** | GCC | GCC | MSVC (Microsoft C++) |
| **런타임** | MSVCRT / UCRT (Native) | cygwin1.dll (Emulation) | MSVC Runtime |
| **호환성** | Windows Native | POSIX / Unix-like | Windows Native |
| **종속성** | 낮음 (가벼움) | 높음 (DLL 필수) | 높음 (Redistributable 필요) |
| **주 목적** | GCC 기반 Windows 개발 | Windows 내 유닉스 환경 구축 | 상용 Windows 앱 개발 |

### 런타임 라이브러리: MSVCRT vs UCRT
MinGW-w64는 두 가지 주요 C 런타임을 지원한다.
- **MSVCRT (Microsoft Visual C++ Runtime)**: 오래된 표준 런타임으로, 거의 모든 Windows 버전에 기본 포함되어 있어 호환성이 매우 높지만, 최신 C 표준 준수율이 낮다.
- **UCRT (Universal C Runtime)**: Windows 10부터 도입된 최신 표준 런타임이다. C99, C11 등 최신 표준을 더 잘 준수하며, Microsoft Visual Studio와 동일한 런타임을 사용하므로 현대적인 Windows 개발에 권장된다.

## 3. 설치 및 환경 설정
과거에는 개별 설치 파일을 제공했으나, 현재는 패키지 관리 시스템인 **MSYS2**를 통한 설치가 강력히 권장된다. MSYS2는 `pacman`이라는 패키지 매니저를 통해 GCC, GDB, Make 등 필요한 도구를 최신 버전으로 손쉽게 관리할 수 있게 해준다.

### 설치 단계
1. **MSYS2 설치**: [msys2.org](https://www.msys2.org/)에서 설치 프로그램을 다운로드하고 실행한다.
2. **패키지 설치**: MSYS2 터미널(UCRT64 또는 MINGW64)을 실행한 후 아래 명령어를 입력하여 툴체인을 설치한다. 최신 Windows 런타임인 UCRT(Universal C Runtime)를 사용하는 툴체인을 설치하는 것을 권장한다.
   ```bash
   pacman -S mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-gdb mingw-w64-ucrt-x86_64-make
   ```
3. **환경 변수(PATH) 설정**:
   - Windows 검색창에 '시스템 환경 변수 편집' 입력 $\rightarrow$ [환경 변수] 버튼 클릭.
   - '시스템 변수' 목록에서 `Path`를 선택하고 [편집] 클릭.
   - MSYS2의 바이너리 경로(예: `C:\msys64\ucrt64\bin`)를 추가한다.

### 설치 확인
터미널(CMD 또는 PowerShell)을 열어 다음 명령어를 입력하여 설치 여부를 확인한다.
```bash
gcc --version
```
정상적으로 설정되었다면 GCC의 버전 정보와 타겟 플랫폼 정보가 출력된다.

## 4. 기본 사용법 및 컴파일 과정
MinGW를 이용한 개발 워크플로우는 일반적으로 **소스 코드 작성 $\rightarrow$ 컴파일 $\rightarrow$ 링크 $\rightarrow$ 실행 파일 생성**의 과정을 거친다.

### Hello World 예제
가장 기본적인 C 언어 예제 코드(`main.c`)는 다음과 같다.
```c
#include <stdio.h>

int main() {
    printf("Hello, MinGW World!\n");
    return 0;
}
```

### 컴파일 워크플로우
1. **소스 작성**: `main.c` 파일 작성.
2. **컴파일 및 링크**: `gcc` 명령어를 사용하여 소스 코드를 기계어로 번역하고 라이브러리를 연결한다.
3. **실행**: 생성된 `.exe` 파일을 실행한다.

### 컴파일 명령어 예시 및 옵션
```bash
# 기본 컴파일 (출력 파일명을 main.exe로 지정)
gcc main.c -o main.exe

# 디버깅 정보를 포함하여 컴파일 (-g 옵션)
gcc -g main.c -o main.exe

# 최적화 옵션을 적용하여 컴파일 (-O2 옵션)
gcc -O2 main.c -o main.exe

# C++ 파일 컴파일 시 (g++ 사용)
g++ main.cpp -o main.exe
```

**주요 컴파일 옵션 설명:**
- `-o [파일명]`: 출력될 실행 파일의 이름을 지정한다.
- `-g`: 디버깅 정보를 생성하여 GDB와 같은 디버거에서 소스 코드 레벨의 디버깅이 가능하게 한다.
- `-O2`: 코드 실행 속도를 높이기 위한 최적화를 수행한다. (O0: 최적화 없음, O1: 기본 최적화, O3: 공격적 최적화)
- `-Wall`: 모든 일반적인 경고 메시지를 출력하여 잠재적인 버그를 찾는 데 도움을 준다.

## 5. MinGW-w64 (현대적 표준)
초기 MinGW는 32비트(x86) 아키텍처만을 지원했다는 한계가 있었다. 이를 해결하기 위해 등장한 것이 **MinGW-w64** 프로젝트이며, 현재 대부분의 Windows GCC 환경은 이 프로젝트를 기반으로 한다.

- **64비트 지원**: x86-64 아키텍처를 공식 지원하여 64비트 Windows 애플리케이션 개발이 가능해졌다.
- **최신 표준 대응**: C11, C17 및 C++11, 14, 17, 20 등 최신 언어 표준을 빠르게 반영한다.
- **더 넓은 API 커버리지**: Windows API에 대한 정의를 더 광범위하게 제공하여 시스템 프로그래밍 시 제약이 적다.
- **멀티 타겟팅**: 동일한 소스 코드로 32비트와 64비트 바이너리를 모두 생성할 수 있는 유연성을 제공한다.

## 6. 활용 및 통합 개발 환경(IDE) 연동
MinGW는 독립적인 컴파일러이므로, 생산성을 높이기 위해 다양한 IDE와 연동하여 사용한다.

- **Visual Studio Code (VS Code)**:
  - `C/C++` 확장 팩(Microsoft 제공)을 설치한다.
  - `Ctrl+Shift+P` $\rightarrow$ `C/C++: Edit Configurations (UI)`에서 `Compiler path`를 MinGW의 `gcc.exe` 경로(예: `C:\msys64\ucrt64\bin\gcc.exe`)로 지정한다.
  - `tasks.json` 파일을 설정하여 빌드 자동화를 구축한다.
- **CLion**:
  - [Settings] $\rightarrow$ [Build, Execution, Deployment] $\rightarrow$ [Toolchains]에서 `MinGW`를 추가한다.
  - `Environment` 항목에서 MinGW가 설치된 루트 경로(예: `C:\msys64\ucrt64`)를 지정하면 자동으로 GCC와 GDB를 감지한다.
- **Code::Blocks**:
  - 설치 시 MinGW가 포함된 번들 버전을 설치하거나, [Settings] $\rightarrow$ [Compiler] $\rightarrow$ [Global compiler settings] $\rightarrow$ [Toolchain executables] 탭에서 설치 경로를 설정한다.

## 7. 런타임 DLL 배포 방법
MinGW로 빌드한 프로그램을 다른 PC에서 실행할 때, `libgcc_s_dw2-1.dll`이나 `libstdc++-6.dll` 같은 런타임 DLL이 없다는 오류가 발생할 수 있다. 이를 해결하는 방법은 두 가지이다.

### 방법 1: 정적 링크 (Static Linking) - 권장
컴파일 시 라이브러리를 실행 파일 내부에 포함시켜 DLL 의존성을 제거하는 방법이다.
```bash
gcc main.c -o main.exe -static-libgcc -static-libstdc++ -static
```
이 방법을 사용하면 파일 크기는 약간 커지지만, 별도의 DLL 파일 없이 `.exe` 단독으로 실행 가능하다.

### 방법 2: DLL 동봉 배포
컴파일된 `.exe` 파일과 동일한 폴더에 필요한 DLL 파일들을 함께 복사하여 배포하는 방법이다. DLL 파일은 보통 `C:\msys64\ucrt64\bin` 경로에서 찾을 수 있다.

## 8. 트러블슈팅 및 FAQ

**Q: `gcc` 명령어를 입력했는데 '내부 또는 외부 명령, 실행 가능한 프로그램, 또는 배치 파일이 아닙니다'라고 뜹니다.**
**A:** 시스템 환경 변수(PATH) 설정이 누락되었거나, 설정 후 터미널을 재시작하지 않은 경우입니다. PATH에 `bin` 폴더 경로가 정확히 추가되었는지 확인하고 터미널을 완전히 종료 후 다시 실행하십시오.

**Q: `make` 명령어가 작동하지 않습니다.**
**A:** MSYS2에서 설치한 패키지 이름이 `mingw-w64-ucrt-x86_64-make`인 경우, 실행 파일 이름이 `mingw32-make.exe`일 수 있습니다. 이를 `make`로 사용하고 싶다면 파일을 복사하여 이름을 바꾸거나, 별칭(alias)을 설정하십시오.

**Q: 컴파일 시 `undefined reference to ...` 에러가 발생합니다.**
**A:** 이는 링크 단계에서 필요한 라이브러리를 찾지 못했을 때 발생합니다. `-l` 옵션을 사용하여 필요한 라이브러리를 명시하십시오. (예: `gcc main.c -o main.exe -lws2_32` $\rightarrow$ Windows 소켓 라이브러리 링크)