Rust 文件操作全解：路径、读写与目录管理

路径管理：跨平台兼容性

Rust 提供了高度抽象的路径类型，确保代码在不同操作系统间无缝运行。主要涉及两个核心类型：

• PathBuf：具有所有权且可变，类似于字符串类型的 String，适合构建路径。
• Path：表示路径切片的引用类型，类似于 str。

第1步：初始化路径类型

可以通过字符串字面量或 from 方法将文本转换为路径对象。在处理 Windows 路径时，建议使用原始字符串字面量（如 r"..."）以避免转义字符冲突。

use std::path::{Path, PathBuf};

fn main() {
    // 基于字符串切片创建不可变路径切片
    let path = Path::new("./data/logs.txt");

    // 获取父路径
    let parent = path.parent().unwrap();

    // 提取不包含扩展名的文件名
    let file_stem = path.file_stem().unwrap();

    println!("File stem: {:?}", file_stem);

    // 创建可变的 PathBuf 并拼接路径
    let mut base = PathBuf::from(r"C:\workspaces");
    base.push("src");
}

目录与文件的底层管理

使用 std::fs 模块执行物理层面的文件操作。在执行破坏性操作（如删除）前，务必确认路径状态。

第2步：安全的目录增删

区分单级创建与级联创建，并注意递归删除的风险。

• create_dir(path)：仅当上级目录存在时创建空目录。
• create_dir_all(path)：自动创建中间缺失的目录层级。

注意：remove_dir_all 会永久删除指定目录及其下所有内容，请谨慎调用。

use std::fs;

fn manage_dirs() -> std::io::Result<()> {
    // 创建多级目录结构
    fs::create_dir_all("./logs/2023")?;
    
    // 清理指定的目录树
    fs::remove_dir_all("./temp_backup")?;
    
    Ok(())
}

第3步：文件的建立与销毁

std::fs::File 是连接内存缓冲区与磁盘文件的桥梁。File::create 会在打开模式下截断现有文件，若需保留原内容请使用追加模式。

use std::fs::File;
use std::io::prelude::*;

fn init_file() -> std::io::Result<()> {
    let mut f = File::create("config.json")?;
    f.write_all(b"{}")?;
    f.flush()?;
    Ok(())
}

精细化的文件读取控制

Rust 通过 trait 系统实现灵活的 I/O 操作。通过 open 获取 File 实例后，可利用不同策略读取数据。

第4步：使用 OpenOptions 配置权限

若需同时开启读与写，或进行字节定位，应使用构建器模式配置打开参数：

use std::fs::OpenOptions;

let f = OpenOptions::new()
    .read(true)
    .append(true) // 保持指针在末尾
    .create(true)
    .open("app.log")?;

第5步：执行流式读取与偏移

结合 SeekFrom 可精准定位文件位置。对于大文件，建议分块读取以控制内存消耗：

use std::fs::File;
use std::io::{Read, Seek, SeekFrom};

fn read_chunk(f: &mut File) -> std::io::Result<()> {
    // 定位到距离起始点 100 字节处
    f.seek(SeekFrom::Start(100))?;

    let mut buf = String::new();
    f.read_to_string(&mut buf)?;
    println!("Read chunk: {}", buf.len());
    Ok(())
}

高效的数据写入策略

写入文件需处理缓存刷新问题。未调用的 flush() 可能导致数据滞留缓冲区而未落盘。

第6步：安全写入内容

write_all 保证所有字节成功写入或抛出错误，比单次 write 更安全：

fn write_data(f: &mut File) -> std::io::Result<()> {
    f.write_all(b"New content appended.")?;
    f.flush()?; // 确保数据同步至磁盘
    Ok(())
}