Ответ

В языке программирования 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,
        }
    }
}

Ключевые особенности:

• Видимость поля или метода не может превышать видимость самой структуры или модуля
• Для вложенных структур итоговая видимость определяется пересечением модификатора и видимости всех родительских модулей
• Публичные структуры с приватными полями поддерживают паттерн инкапсуляции (конструкторы/getter-методы)

Вопросы с подвохом.

Если структура объявлена как pub, а её поля — без модификатора, можно ли к ним обратиться из другого модуля?

Нет, только сама структура становится публичной, но её поля остаются приватными внутри модуля. Для доступа к полю оно также должно быть объявлено с pub.

Что произойдёт, если объявить структуру как pub(crate), а поле внутри неё — pub?

Видимость ограничивается самой структурой. Даже если поле pub, получить к нему доступ за пределами крейта невозможно, так как структура недоступна.

pub(crate) struct Secret {
    pub data: i32, // pub не "проходит сквозь" pub(crate)
}

Можно ли объявить структуру pub внутри приватного модуля и получить к ней доступ извне?

Нет. Итоговая видимость определяется минимумом между структурой и модулем. Если модуль приватен, структуры и функции внутри него также не видны вне этого модуля.

Типовые ошибки и анти-паттерны

• Оставлять поля структур публичными при проектировании сложных API
• Открывать видимость структуры без необходимости с «pub»
• Пытаться расширить видимость поля, игнорируя ограничение по модулю

Пример из жизни

Негативный кейс

В проекте вся структура сделана публичной с открытыми полями для ускорения разработки. Позже стало сложно поддерживать обратную совместимость и контролировать доступ к полям, так как их изменяли напрямую.

Плюсы:

• Быстрый старт; нет необходимости реализовывать геттеры

Минусы:

• Нет контроля за изменением данных; ухудшение инкапсуляции
• Сложность изменений внутренней структуры

Позитивный кейс

Для публичной структуры реализованы приватные поля и публичные методы-конструкторы/аксессоры. Структура экстпортируется только на нужном уровне модуля.

Плюсы:

• Надёжная инкапсуляция; удобное API
• Возможность менять внутреннюю реализацию без ломки клиентов кода

Минусы:

• Приходится писать дополнительные методы; чуть больше кода