Rust / 系统课时
处理路径与目录
处理路径与目录
本课解决路径拼接和目录遍历中的跨平台问题。你将使用 Path 表示借用路径、用 PathBuf 构建自有路径,并创建目录、写入示例文件后按稳定顺序列出目录内容。
学习目标
- 区分
Path与PathBuf的职责 - 使用
join构建跨平台路径并创建多级目录 - 使用
read_dir遍历目录并处理文件名边界
Path 与 PathBuf 怎么选
Path 类似字符串切片,通常以 &Path 形式借用已有路径;PathBuf 类似 String,拥有路径数据,可以继续拼接和修改。函数参数只需要读取路径时,优先接收 &Path,这样既能传入 Path,也能传入 PathBuf 的引用。
路径不要手工拼接 / 或 \。使用 join 后,标准库会按照当前操作系统的路径规则组合各部分。
| 类型 | 是否拥有数据 | 典型用途 |
|---|---|---|
Path |
否 | 函数参数、路径检查、读取路径信息 |
PathBuf |
是 | 动态构建、保存和修改路径 |
创建目录并遍历内容
下面的程序创建 path-demo-workspace/src,写入两个 Rust 文件,再调用接收 &Path 的函数读取目录。由于 read_dir 不保证返回顺序,示例先排序,确保输出稳定。
use std::error::Error;
use std::fs;
use std::path::{Path, PathBuf};
fn list_file_names(dir: &Path) -> Result<Vec<String>, Box<dyn Error>> {
let mut names = Vec::new();
for entry_result in fs::read_dir(dir)? {
let entry = entry_result?;
let file_name = entry.file_name();
// 文件名可能不是 UTF-8,因此使用 to_string_lossy 保证可以展示。
names.push(file_name.to_string_lossy().into_owned());
}
names.sort();
Ok(names)
}
fn main() -> Result<(), Box<dyn Error>> {
let root = PathBuf::from("path-demo-workspace");
// 清理上次运行结果,使本示例每次都得到相同目录内容。
if root.exists() {
fs::remove_dir_all(&root)?;
}
let src_dir = root.join("src");
fs::create_dir_all(&src_dir)?;
fs::write(src_dir.join("main.rs"), "fn main() {}\n")?;
fs::write(
src_dir.join("lib.rs"),
"pub fn version() -> &'static str { \"1.0\" }\n",
)?;
println!("目录已创建: {}", src_dir.is_dir());
for name in list_file_names(&src_dir)? {
println!("- {name}");
}
Ok(())
}预期输出
目录已创建: true
- lib.rs
- main.rs程序执行后会在当前工作目录留下 path-demo-workspace。如果不希望保留测试目录,可在验证完成后调用 fs::remove_dir_all 清理。
检查路径与条目类型
Path 提供 exists、is_file 和 is_dir 等便捷方法,但这些检查与后续操作之间可能发生状态变化。即使检查通过,真正读取或写入时仍然必须处理错误。
遍历目录时,read_dir 返回的是迭代器,每一项本身也是 Result<DirEntry>。原因是目录可以成功打开,但读取某个条目时仍可能因权限、文件删除或设备错误而失败。示例在循环中对每个条目继续使用 ?,避免静默忽略问题。
跨平台与安全边界
显示路径时可使用 path.display(),但不同系统的分隔符可能不同,因此不要把显示字符串当作固定格式参与业务判断。需要判断扩展名或文件名时,应使用 extension、file_name 等路径方法。
接收用户提供的相对路径时,还要防止 .. 越过允许目录。仅调用 join 不会自动阻止目录穿越;实际项目应先确定允许访问的根目录,再规范化并校验最终路径仍位于该根目录内。
本课总结
Path适合借用和检查路径,PathBuf适合拥有并动态构建路径- 使用
join和create_dir_all可以避免手工处理平台分隔符 read_dir的顺序不固定,且每个目录条目都可能单独读取失败
下一课预告
下一课将把文件与路径能力用于命令行程序,学习接收参数并把输入、处理结果和错误信息组织成可用工具。