답변

Rust 프로그래밍 언어에서 구조체의 메서드 및 필드에 대한 접근 수준(가시성)은 수정자에 의해 조절됩니다: pub, pub(crate), pub(super) 및 수정자가 없는 경우(기본적으로는 비공개)입니다.

질문의 배경

Rust는 원래 신뢰성과 구성 요소의 격리를 제공하도록 설계되었습니다. 구조체의 내부 구성 요소에 대한 접근 제어는 데이터를 캡슐화하고 구현 세부 사항을 숨기며 필요한 인터페이스만 공개하는 것을 가능하게 합니다.

문제

개발자는 종종 구조체가 공개되었지만 필드는 비공개로 남아 있거나, 필드의 공개가 구조체나 모듈의 가시성 제약으로 인해 충분하지 않은 상황에 직면하게 됩니다. 특히 중첩 수준을 이해하는 것이 어렵습니다: 공개 중첩 구조체는 포함된 모듈이 숨겨져 있다면 접근할 수 없으며, 그 반대의 경우도 마찬가지입니다.

해결책

Rust에서는 접근 수정자가 구조체, 그 필드 및 메서드뿐만 아니라 모듈과 함수에 적용됩니다. 다음과 같은 수준이 있습니다:

pub — 모든 곳에서 접근 가능.
pub(crate) — 현재 크레이트 내에서만 접근 가능.
pub(super) — 부모 모듈에서만 접근 가능.
수정자가 없는 경우 — 현재 모듈 내에서 비공개.

코드 예:

mod outer {
    pub struct PublicStruct {
        pub field: u32,
        hidden: u32,
    }

    pub(crate) struct CrateStruct {
        pub value: i32,
    }

    struct PrivateStruct {
        pub secret: i32,
    }

    pub mod inner {
        pub(super) struct SuperStruct {
            pub super_field: u8,
        }
    }
}

주요 특징:

필드나 메서드의 가시성은 구조체나 모듈의 가시성을 초과할 수 없습니다.
중첩 구조체에 대한 최종 가시성은 수정자와 모든 부모 모듈의 가시성의 교차에 의해 결정됩니다.
공개 구조체가 비공개 필드를 가질 경우 캡슐화 패턴(생성자/게터 메서드)을 지원합니다.

질문 포인트.

구조체가 pub로 선언되고 필드는 수정자가 없을 때 다른 모듈에서 접근할 수 있습니까?

아니요, 구조체 자체만 공개되고 필드는 모듈 내에서 비공개로 남습니다. 필드에 접근하려면 그것도 pub으로 선언되어야 합니다.

구조체가 pub(crate)로 선언되고 그 안의 필드가 pub이라면 어떻게 됩니까?

가시성이 구조체 자체로 제한됩니다. 필드가 pub이라 할지라도 크레이트 외부에서는 접근할 수 없으며, 구조체가 접근할 수 없기 때문입니다.

pub(crate) struct Secret {
    pub data: i32, // pub은 "pub(crate)"를 "통과하지" 않습니다.
}

비공식 모듈 내에 구조체를 pub으로 선언하고 외부에서 접근할 수 있습니까?

아니요. 최종 가시성은 구조체와 모듈 사이의 최소값으로 결정됩니다. 모듈이 비공식이면 그 안의 구조체와 함수는 모듈 외부에서 볼 수 없습니다.

일반적인 실수 및 안티 패턴

복잡한 API 설계 시 구조체의 필드를 공개로 두기
불필요하게 "pub"로 구조체의 가시성을 열기
모듈 제약을 무시하고 필드의 가시성을 확장하려고 시도하기

실제 예

부정적인 사례

프로젝트에서 모든 구조체를 공개로 하고 필드를 개방하여 개발 속도를 높였습니다. 나중에 필드에 대한 접근을 직접 수정하여 호환성을 유지하기 어려워졌습니다.

장점:

빠른 시작; 게터 구현이 필요 없음.

단점:

데이터 변경에 대한 통제 부족; 캡슐화 저하.
내부 구조 변경의 복잡성.

긍정적인 사례

공개 구조체에 비공식 필드와 공개 생성자/액세서 메서드를 구현했습니다. 구조체는 필요한 모듈 수준에서만 내보냅니다.