Rust / 系统课时

导入与重导出

导入与重导出

本课解决模块路径过长、名称冲突和公共接口不稳定的问题。你将使用 use、as 与 pub use 整理调用路径,并理解导入只改变当前作用域中的写法,而重导出会真正影响库的外部使用方式。

学习目标

  • 使用 use 将长路径引入当前作用域
  • 使用 as 解决同名项冲突并改善可读性
  • 使用 pub use 设计稳定、简洁的公共接口

使用 use 缩短路径

use 会把指定路径绑定到当前作用域,后续代码可以直接使用路径末尾的名称。它不会移动模块,也不会改变原项目结构,只是减少重复书写。

下面的示例在单个文件中定义模块,再从根模块导入 Config 和 connect。代码可直接保存为 src/main.rs 运行。

rust
mod network {
    pub struct Config {
        pub host: String,
        pub port: u16,
    }

    pub fn connect(config: &Config) {
        println!("connect to {}:{}", config.host, config.port);
    }
}

use crate::network::{connect, Config};

fn main() {
    let config = Config {
        host: String::from("127.0.0.1"),
        port: 8080,
    };

    connect(&config);
}

运行命令:

bash
cargo run

预期输出:

text
connect to 127.0.0.1:8080

同一模块中的多个项可以使用花括号合并导入。use crate::network::{connect, Config}; 比两条独立导入更紧凑,但不要为了缩短代码而一次导入大量未使用名称。

使用 as 处理名称冲突

当不同模块暴露同名类型或函数时,直接导入会产生重复定义错误。此时可以用 as 为其中一个名称创建当前作用域内的别名。

rust
mod text {
    pub struct Formatter;
}

mod json {
    pub struct Formatter;
}

use crate::json::Formatter as JsonFormatter;
use crate::text::Formatter as TextFormatter;

fn main() {
    let _text = TextFormatter;
    let _json = JsonFormatter;
    println!("two formatters are available");
}

预期输出:

text
two formatters are available

别名应表达来源或用途,例如 JsonFormatter、IoResult。避免使用 F1、F2 之类难以理解的缩写。

使用 pub use 重导出接口

普通 use 只对当前模块生效,外部调用者仍需知道原始模块路径。pub use 会把导入项再次公开,使调用者可以从新的路径访问它。

rust
mod internal {
    pub struct Client;

    impl Client {
        pub fn new() -> Self {
            Self
        }
    }
}

pub use crate::internal::Client;

fn main() {
    let _client = Client::new();
    println!("client created");
}

预期输出:

text
client created

在库项目中,常把内部实现放入多个私有模块,再在 lib.rs 中通过 pub use 暴露少量稳定入口。这样即使内部目录调整,外部用户仍可继续使用 my_crate::Client。

路径选择与常见边界

以 crate:: 开头的是从当前 crate 根模块出发的绝对路径;self:: 表示当前模块;super:: 表示父模块。公共代码优先使用清晰的绝对路径,局部子模块引用则可使用相对路径。

use 本身不会绕过可见性规则。目标项若未声明为 pub,即使路径正确也不能从父模块或外部 crate 访问。编译器提示未使用导入时,应删除无效导入,而不是用通配符掩盖问题。

本课总结

  • use 只简化当前作用域中的路径,不改变模块结构
  • as 适合解决同名冲突,并应使用有意义的别名
  • pub use 能隐藏内部布局,为库提供稳定的公共入口

下一课预告

下一课将进入 Cargo 依赖管理,学习如何声明版本、启用特性,并区分普通依赖、可选依赖和开发依赖。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

导入与重导出

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通