모듈 기초

Rust 프로그램이 커지면 모든 내용을 하나의 파일에 유지하는 일이 번거로워집니다. Rust의 모듈 시스템을 사용하면 구조체와 그 구현을 별도의 파일로 옮겨 코드를 정리할 수 있습니다.

별도의 파일에 모듈을 만들려면 원하는 모듈 이름으로 새 파일을 만들기만 하면 됩니다. 예를 들어 player 모듈을 만들려면 player.rs라는 파일을 만듭니다:

// player.rs
struct Player {
    name: String,
    score: u32,
}

impl Player {
    fn new(name: String) -> Player {
        Player { name, score: 0 }
    }
}

mod 키워드로 선언하면 이 모듈을 main 파일에서 사용할 수 있습니다. 이렇게 하면 Rust는 해당 이름의 파일을 찾습니다:

// main.rs
mod player;

fn main() {
    // 이제 player 모듈의 항목에 접근할 수 있습니다
}

mod player; 선언은 Rust에게 player.rs의 내용을 찾아 포함하도록 지시합니다. 해당 파일의 코드를 프로그램에 연결하는 것이라고 생각하면 됩니다. 모듈 이름은 ( .rs 확장자를 제외하고) 파일 이름과 정확히 일치해야 합니다.

이러한 분리는 관련된 코드를 함께 유지합니다. struct 정의와 모든 메서드는 하나의 전용 파일에 있으며, main.rs는 프로그램의 진입점에 집중합니다. 다음 레슨에서는 모듈에 배치한 items에 실제로 액세스하는 방법을 배웁니다.