조건부 컴파일
ifdef와 매크로를 알아봅니다
조건부 컴파일은(는) CoddyKit의 무료 C Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 C Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. C Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
전처리기
컴파일러가 코드를 보기 전에 전처리기가 실행됩니다. 전처리기는 #으로 시작하는 모든 줄, 즉 포함, 매크로, 조건문을 처리합니다.
조건부 컴파일을 사용하면 이 단계에서 평가한 조건에 따라 코드 블록을 포함하거나 제외할 수 있으므로, 하나의 소스에서 서로 다른 빌드를 만들 수 있습니다.
매크로 정의
#define은 매크로를 만듭니다. 값을 지정하지 않으면 나중에 검사할 수 있는 플래그일 뿐입니다.
객체 형태의 매크로는 이름을 텍스트로 바꾸고, 플래그는 무언가가 설정되었다는 표시만 합니다.
#define MAX_USERS 100 /* value macro */
#define DEBUG /* flag macro */ifdef와 ifndef
#ifdef NAME은 NAME이 정의된 경우에만 블록을 유지합니다. #ifndef은 NAME이 정의되지 않은 경우에만 블록을 유지합니다.
여기서는 디버그 출력이 디버그 빌드에서만 존재합니다. DEBUG를 정의하지 않으면 컴파일러는 해당 줄을 아예 보지 못합니다.
#include <stdio.h>
#define DEBUG
int main(void) {
#ifdef DEBUG
printf("debug: starting\n");
#endif
printf("running\n");
return 0;
}if, elif, else
#if는 정수 상수 표현식을 평가합니다. #elif 및 #else와 결합하면 여러 경우 중 하나를 선택할 수 있습니다.
이 방식은 버전 번호 매크로를 기준으로 코드를 선택합니다.
#include <stdio.h>
#define VERSION 2
int main(void) {
#if VERSION >= 2
printf("new feature on\n");
#else
printf("legacy mode\n");
#endif
return 0;
}defined 연산자
#if 내부에서는 defined(NAME)으로 정의 여부를 검사하고, && 및 ||로 검사를 결합할 수 있습니다.
이는 하나의 이름만 검사할 수 있는 #ifdef보다 유연합니다.
#if defined(LINUX) && !defined(EMBEDDED)
/* desktop Linux code */
#endif컴파일 시 정의하기
매크로를 코드에 직접 하드코딩할 필요는 없습니다. -D 플래그로 명령줄에서 매크로를 정의할 수 있습니다.
이렇게 하면 소스를 수정하지 않고 빌드 시스템에서 기능을 전환할 수 있습니다. -DDEBUG는 모든 파일의 맨 위에 #define DEBUG를 작성하는 것과 같습니다.
gcc -DDEBUG -DVERSION=3 -o app app.c플랫폼 감지
컴파일러는 대상 플랫폼을 설명하는 매크로를 미리 정의합니다. 이 매크로를 사용하면 이식 가능한 코드를 작성할 수 있습니다.
_WIN32— Windows(32비트 또는 64비트)__linux__— Linux__APPLE__— macOS / iOS
이 매크로를 기준으로 분기하여 올바른 플랫폼 API를 호출합니다.
#ifdef _WIN32
#include <windows.h>
#else
#include <unistd.h>
#endif헤더 포함 방지
조건문의 대표적인 용도는 포함 방지 매크로입니다. 이를 사용하면 헤더가 두 번 처리되는 것을 막을 수 있습니다.
처음 포함할 때 방지 매크로를 정의하고, 이후에는 매크로가 이미 정의되어 있으므로 포함된 본문을 건너뜁니다.
#ifndef UTILS_H
#define UTILS_H
int add(int a, int b);
#endif /* UTILS_H */코드 주석 처리
#if 0 ... #endif는 이미 주석이 포함된 블록도 안정적으로 비활성화합니다.
/* */와 달리 안전하게 중첩할 수 있으므로, 디버깅 중 코드를 일시적으로 제외하는 표준적인 방법입니다.
#if 0
legacy_function(); /* disabled for now */
/* with internal comments too */
#endif전처리기 출력 확인
컴파일러가 정확히 무엇을 컴파일하는지 확인하려면 -E를 사용해 전처리기만 실행합니다.
이렇게 하면 모든 포함, 매크로, 조건문이 확장되므로 매크로가 예상대로 동작하지 않을 때 매우 유용합니다.
gcc -E app.c | less실제 기능 전환
일반적인 방식은 하나의 설정 헤더에서 프로젝트 전체의 기능을 켜거나 끄는 것입니다.
#define 하나만 바꾸면 모든 파일의 조건부 블록이 이에 반응합니다. 이렇게 하면 선택적 기능과 핵심 코드를 깔끔하게 분리할 수 있습니다.
#include <stdio.h>
#define FEATURE_LOGGING 1
int main(void) {
#if FEATURE_LOGGING
printf("logging enabled\n");
#endif
printf("app ready\n");
return 0;
}빠른 확인
명령줄에서 정의한 매크로의 동작을 예측해 보세요.
복습
이제 조건부 컴파일을 제어할 수 있습니다.
#ifdef/#ifndef는 매크로가 정의되었는지 검사합니다.#if/#elif/#else는defined()와 함께 정수 상수 표현식을 평가합니다.-DNAME은 기능 전환을 위해 명령줄에서 매크로를 정의합니다.- 미리 정의된 플랫폼 매크로를 사용하면 이식 가능한 코드를 작성할 수 있고, 포함 방지 매크로를 사용하면 중복 포함을 막을 수 있습니다.
다음 단계: 여러 파일에 걸쳐 코드 구성하기
자주 묻는 질문
“조건부 컴파일” 강의는 무료인가요?
네 — “조건부 컴파일” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 C Academy 강의 전체를 잠금 해제할 수 있습니다. C Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“조건부 컴파일”에서 뭘 배우나요?
ifdef와 매크로를 알아봅니다 브라우저에서 직접 실행하는 실습 코드로 C Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
C Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 C Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.
“조건부 컴파일” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 C Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 C Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.