[Rust 공식문서 한국어 정리] ⑰. The rustc Book

[Rust 공식문서 한국어 정리] ⑰. Rust 컴파일러 rustc

원문 제목: The rustc Book
작성자: The Rust Project

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📌 1. 서론 — 이 문서가 다루는 내용
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

rustc는 Rust 공식 컴파일러로, Rust 소스 코드를 실행 가능한 바이너리로 변환합니다.
이 문서에서는 rustc의 낭부 구조, 컴파일 과정, 그리고 고급 사용법을 다룹니다.
Cargo를 통해 간접적으로 사용하는 것이 일반적이지만, rustc를 직접 다루는 법도 알아야 합니다.
특히 크로스 컴파일, 커스텀 타겟, 그리고 컴파일러 플래그를 직접 제어할 때 필요합니다.
컴파일러의 동작 원리를 이해하면 성능 최적화와 디버깅에 큰 도움이 됩니다.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📌 2. 핵심 개념
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

① 컴파일 과정 (Compile Pipeline)
rustc는 소스 코드를 파싱하여 AST를 만들고, MIR로 변환한 뒤 LLVM IR을 생성합니다.
이 과정에서 타입 검사, borrow 검사, 최적화 등이 순차적으로 수행됩니다.

② 타겟 트리플 (Target Triple)
rustc는 다양한 아키텍처와 OS를 지원합니다.
x86_64-unknown-linux-gnu, aarch64-apple-darwin 등 타겟 트리플로 지정합니다.

③ 컴파일러 플래그
-C opt-level, -C lto, -C target-cpu 등 다양한 최적화 플래그를 제공합니다.
링커 옵션, 코드 생성 옵션, 디버깅 옵션 등 세밀한 제어가 가능합니다.

④ 크로스 컴파일
호스트와 다른 타겟으로 바이너리를 생성할 수 있습니다.
타겟 스펙 JSON 파일을 직접 작성해 커스텀 임베디드 환경도 지원합니다.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📌 3. 주요 내용 상세
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

rustc는 여러 단계를 거쳐 소스 코드를 기계어로 변환합니다.
먼저 렉서(lexer)가 소스를 토큰으로 쪼개고, 파서(parser)가 AST를 만듭니다.
그 후 이름 해결(name resolution)과 타입 검사(type checking)가 이루어집니다.

borrow checker는 소유권 규칙을 검증하여 메모리 안전성을 보장합니다.
이 단계에서 수명(lifetime) 분석과 대여 규칙 검사가 수행됩니다.
MIR(Mid-level IR)로 낮춰진 후에는 추가적인 검사와 최적화가 이루어집니다.

LLVM IR 생성 단계에서는 Rust 특유의 제어 흐름이 LLVM의 표현으로 변환됩니다.
LLVM의 강력한 최적화 패스가 적용되어 효율적인 기계어가 생성됩니다.
링킹 단계에서는 외부 크레이트와 표준 라이브러리가 함께 연결됩니다.

고급 사용법으로는 -Z 플래그를 통한 불안정한 기능 활성화가 있습니다.
-Z time-passes로 각 컴파일 단계의 소요 시간을 측정할 수 있습니다.
-Z unpretty=mir로 MIR을 직접 확인하며 낭부 동작을 분석할 수 있습니다.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📌 4. 실전 활용 / 예시
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

임베디드 개발에서는 커스텀 타겟 JSON을 작성해 메모리 레이아웃을 직접 제어합니다.
성능 최적화가 필요할 때 -C opt-level=3 -C lto=fat으로 최대 최적화를 적용하세요.
컴파일 시간이 느릴 때 -Z time-passes로 병목 지점을 찾아 개선하세요.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📌 5. 정리
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

rustc는 Rust의 핵심 도구이며, 그 낭부 동작을 이해하면 고급 개발이 가능합니다.
Cargo가 대부분의 작업을 추상화하지만, 직접 rustc를 다루는 능력은 필수적입니다.
크로스 컴파일과 커스텀 타겟 지원은 Rust가 다양한 플랫폼에서 활용되는 이유입니다.

📎 출처 링크
https://doc.rust-lang.org/rustc/

#Rust #Rustlang #rustc #컴파일러 #공식문서