Rust中私有模块内调用私有方法报错E0624的正确解决方式

安全阿岳

2026-8-3

Rust中结构体私有实现方法的正确组织方式

针对你遇到的E0624错误，核心问题是Rust默认的私有可见性仅限定在当前模块内，父模块无法访问子模块的私有函数。不需要调整公共/私有函数的模块层级，通过限定可见性修饰符就能完美解决，既保持函数私有性又不暴露到公共API。

解决方法一：用限定可见性修饰私有方法

修改private_module.rs中的方法可见性，指定它仅在crate::foo模块及其子模块内可见：

// src/foo/private_module.rs
use super::Bar; // 导入父模块的Bar结构体

impl Bar {
    // 仅允许crate::foo模块及其子模块访问，外部无法看到该方法
    pub(in crate::foo) fn my_private_function(&self) {}
}

foo.rs中的代码无需修改，此时my_public_function可以正常调用my_private_function，而外部调用者无法访问这个私有方法。

解决方法二：结构体与私有实现同模块，仅导出结构体

如果希望把Bar的核心实现都放在私有模块，仅对外暴露结构体本身，可以这样组织：

private_module.rs中定义结构体和私有方法，用限定可见性开放给父模块：

// src/foo/private_module.rs
pub struct Bar;

impl Bar {
    pub(in crate::foo) fn my_private_function(&self) {}
}

foo.rs中导出结构体，并实现公共方法：

// src/foo.rs
mod private_module;
// 将私有模块中的Bar导出到公共API
pub use private_module::Bar;

impl Bar {
    pub fn my_public_function(&self) {
        self.my_private_function()
    }
}

这种方式同样能保证my_private_function仅在foo模块内可用，外部只能看到Bar和my_public_function。