크레이트와 크레이트 루트
프로젝트 구조
크레이트와 크레이트 루트은(는) CoddyKit의 무료 Learn Rust Coding 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Learn Rust Coding 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Learn Rust Coding 강의에는 총 4개의 강의가 포함되어 있습니다.
크레이트란 무엇인가요?
크레이트는 Rust 컴파일러가 다루는 가장 작은 단위입니다. 크레이트에는 두 종류가 있습니다. 실행 파일로 컴파일되는 바이너리 크레이트와 다른 코드가 의존하는 라이브러리 크레이트입니다.
바이너리와 라이브러리
바이너리 크레이트에는 main 함수가 있으며 실행할 수 있는 프로그램을 생성합니다. 라이브러리 크레이트에는 main이 없고, 다른 크레이트에서 사용할 수 있는 재사용 가능한 항목을 제공합니다.
- 바이너리 루트:
src/main.rs - 라이브러리 루트:
src/lib.rs
크레이트 루트
크레이트 루트는 컴파일러가 시작하는 소스 파일입니다. 모듈 트리의 최상위이며, 경로에서 crate 키워드는 이 루트를 가리킵니다.
fn main() {
crate::greet();
}
fn greet() {
println!("hello from the crate root");
}Cargo와 패키지
패키지는 Cargo가 관리하는 하나 이상의 크레이트이며, Cargo.toml에 설명됩니다. 패키지에는 라이브러리 크레이트를 최대 하나 포함할 수 있고, 바이너리 크레이트는 여러 개 포함할 수 있습니다.
Cargo는 빌드, 테스트, 의존성을 관리합니다.
최소한의 Cargo.toml
매니페스트는 패키지 이름, 버전, 의존성을 선언합니다. Cargo는 이를 읽고 프로젝트를 빌드하는 방법을 파악합니다.
[package]— 이름, 버전, 에디션[dependencies]— 외부 크레이트
표준 프로젝트 구조
Cargo는 일반적인 구조를 따를 것으로 예상합니다.
src/main.rs— 바이너리 크레이트 루트src/lib.rs— 라이브러리 크레이트 루트src/bin/— 추가 바이너리tests/— 통합 테스트
이 관례를 따르면 별도의 구성이 필요하지 않습니다.
모듈은 루트 아래에 존재합니다
크레이트 루트는 모듈을 선언할 수 있으며, 이 모듈들이 모듈 트리를 구성합니다. 작성하는 모든 요소는 이 하나의 루트 파일에서 뻗어나갑니다.
mod utils {
pub fn shout(s: &str) -> String {
s.to_uppercase()
}
}
fn main() {
println!("{}", utils::shout("crate"));
}파일로 분리하기
루트에서 세미콜론과 함께 mod utils;를 선언하면 Cargo가 src/utils.rs를 불러옵니다. 파일의 내용은 해당 모듈의 본문이 되어 여러 파일에 걸쳐 하나의 트리를 유지합니다.
바이너리에서 라이브러리 사용하기
lib.rs와 main.rs가 모두 있는 패키지에서 바이너리는 패키지 이름으로 라이브러리를 참조합니다. 라이브러리는 바이너리가 사용하는 pub 항목을 공개합니다.
이렇게 분리하면 로직은 라이브러리에 두고 진입점은 간결하게 유지할 수 있습니다.
의존성 추가하기
cargo add rand를 실행하거나 Cargo.toml의 [dependencies]를 수정하십시오. Cargo는 crates.io에서 크레이트를 다운로드하고 use로 사용할 수 있게 합니다.
또한 Cargo는 재현 가능한 빌드를 위해 Cargo.lock에 정확한 버전을 고정합니다.
전체 그림
작은 것부터 큰 순서로 보면 모듈 < 크레이트 < 패키지입니다. 모듈은 크레이트를 구성하고, 크레이트 루트는 트리의 기준점이 되며, 패키지와 Cargo가 이 모든 요소를 연결합니다.
빠른 확인
프로젝트 구조에 대한 이해도를 확인해 보십시오.
복습
프로젝트 구조를 배웠습니다.
- 크레이트는 바이너리 또는 라이브러리입니다.
- 크레이트 루트(
main.rs또는lib.rs)가 모듈 트리의 기준점이 됩니다. - 패키지는 크레이트를 묶으며
Cargo.toml에 설명됩니다. - Cargo는 구조, 빌드, 의존성을 관리합니다.
자주 묻는 질문
“크레이트와 크레이트 루트” 강의는 무료인가요?
네 — “크레이트와 크레이트 루트” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Learn Rust Coding 강의 전체를 잠금 해제할 수 있습니다. Learn Rust Coding 강의에는 총 4개의 강의가 포함되어 있습니다.
“크레이트와 크레이트 루트”에서 뭘 배우나요?
프로젝트 구조 브라우저에서 직접 실행하는 실습 코드로 Learn Rust Coding을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Learn Rust Coding을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Learn Rust Coding은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“크레이트와 크레이트 루트” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Learn Rust Coding 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Learn Rust Coding 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.