Rust / 系统课时
导入与重导出
导入与重导出
本课解决模块路径过长、名称冲突和公共接口不稳定的问题。你将使用 use、as 与 pub use 整理调用路径,并理解导入只改变当前作用域中的写法,而重导出会真正影响库的外部使用方式。
学习目标
- 使用
use将长路径引入当前作用域 - 使用
as解决同名项冲突并改善可读性 - 使用
pub use设计稳定、简洁的公共接口
使用 use 缩短路径
use 会把指定路径绑定到当前作用域,后续代码可以直接使用路径末尾的名称。它不会移动模块,也不会改变原项目结构,只是减少重复书写。
下面的示例在单个文件中定义模块,再从根模块导入 Config 和 connect。代码可直接保存为 src/main.rs 运行。
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);
}运行命令:
cargo run预期输出:
connect to 127.0.0.1:8080同一模块中的多个项可以使用花括号合并导入。use crate::network::{connect, Config}; 比两条独立导入更紧凑,但不要为了缩短代码而一次导入大量未使用名称。
使用 as 处理名称冲突
当不同模块暴露同名类型或函数时,直接导入会产生重复定义错误。此时可以用 as 为其中一个名称创建当前作用域内的别名。
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");
}预期输出:
two formatters are available别名应表达来源或用途,例如 JsonFormatter、IoResult。避免使用 F1、F2 之类难以理解的缩写。
使用 pub use 重导出接口
普通 use 只对当前模块生效,外部调用者仍需知道原始模块路径。pub use 会把导入项再次公开,使调用者可以从新的路径访问它。
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");
}预期输出:
client created在库项目中,常把内部实现放入多个私有模块,再在 lib.rs 中通过 pub use 暴露少量稳定入口。这样即使内部目录调整,外部用户仍可继续使用 my_crate::Client。
路径选择与常见边界
以 crate:: 开头的是从当前 crate 根模块出发的绝对路径;self:: 表示当前模块;super:: 表示父模块。公共代码优先使用清晰的绝对路径,局部子模块引用则可使用相对路径。
use 本身不会绕过可见性规则。目标项若未声明为 pub,即使路径正确也不能从父模块或外部 crate 访问。编译器提示未使用导入时,应删除无效导入,而不是用通配符掩盖问题。
本课总结
use只简化当前作用域中的路径,不改变模块结构as适合解决同名冲突,并应使用有意义的别名pub use能隐藏内部布局,为库提供稳定的公共入口
下一课预告
下一课将进入 Cargo 依赖管理,学习如何声明版本、启用特性,并区分普通依赖、可选依赖和开发依赖。