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 不保证返回顺序,示例先排序,确保输出稳定。

rust
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(())
}

预期输出

text
目录已创建: 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 的顺序不固定,且每个目录条目都可能单独读取失败

下一课预告

下一课将把文件与路径能力用于命令行程序,学习接收参数并把输入、处理结果和错误信息组织成可用工具。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理路径与目录

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

登录哪都通