PathBuf 是 Rust 标准库中 std::path 模块提供的一个类型，用于表示文件路径的可变版本。它是 Path 的所有者形式，提供了许多方便的方法来操作和处理文件路径。以下是 PathBuf 常用的方法和简要说明：

创建 PathBuf

use std::path::PathBuf;

// 使用 new 方法创建一个空的 PathBuf
let mut path = PathBuf::new();

// 从字符串字面量创建 PathBuf
let path = PathBuf::from("/some/path/to/file");

// 从操作系统特定的字符串创建 PathBuf
let os_str = std::ffi::OsStr::new("/some/path/to/file");
let path = PathBuf::from(os_str);

追加和拼接路径

use std::path::PathBuf;

// 使用 push 方法追加路径
let mut path = PathBuf::from("/some/path");
path.push("to");
path.push("file");
assert_eq!(path, PathBuf::from("/some/path/to/file"));

// 使用 join 方法拼接路径
let path = PathBuf::from("/some/path").join("to").join("file");
assert_eq!(path, PathBuf::from("/some/path/to/file"));

获取路径的各个部分

use std::path::PathBuf;

// 获取文件名
let path = PathBuf::from("/some/path/to/file.txt");
assert_eq!(path.file_name(), Some(std::ffi::OsStr::new("file.txt")));

// 获取父路径
let parent = path.parent();
assert_eq!(parent, Some(Path::new("/some/path/to")));

// 获取扩展名
assert_eq!(path.extension(), Some(std::ffi::OsStr::new("txt")));

// 获取路径的组件
for component in path.components() {
    println!("{:?}", component);
}

// 获取路径的根组件
assert_eq!(path.root(), Some("/"));

转换为其他类型

use std::path::PathBuf;
use std::ffi::OsStr;

// 转换为字符串切片
let path = PathBuf::from("/some/path/to/file.txt");
let path_str = path.to_str().unwrap(); // 返回 Option<&str>
assert_eq!(path_str, "/some/path/to/file.txt");

// 转换为 OsStr
let os_str = path.as_os_str();
assert_eq!(os_str, OsStr::new("/some/path/to/file.txt"));

标准路径操作

use std::path::PathBuf;

// 获取绝对路径
let path = PathBuf::from("file.txt");
let absolute_path = path.canonicalize().unwrap(); // 返回 Result<PathBuf>
println!("{:?}", absolute_path);

// 判断路径是否存在
let exists = path.exists();
println!("Path exists: {}", exists);

// 判断是否是文件
let is_file = path.is_file();
println!("Is file: {}", is_file);

// 判断是否是目录
let is_dir = path.is_dir();
println!("Is directory: {}", is_dir);

示例代码

以下是一个完整的示例，演示如何使用 PathBuf 处理文件路径：

use std::path::PathBuf;

fn main() {
    // 创建一个 PathBuf
    let mut path = PathBuf::from("/some/path");
    
    // 追加路径
    path.push("to");
    path.push("file.txt");
    println!("Path: {:?}", path);
    
    // 获取文件名
    if let Some(file_name) = path.file_name() {
        println!("File name: {:?}", file_name);
    }
    
    // 获取父路径
    if let Some(parent) = path.parent() {
        println!("Parent path: {:?}", parent);
    }
    
    // 获取扩展名
    if let Some(extension) = path.extension() {
        println!("Extension: {:?}", extension);
    }
    
    // 获取路径的各个组件
    for component in path.components() {
        println!("Component: {:?}", component);
    }
    
    // 转换为字符串切片
    if let Some(path_str) = path.to_str() {
        println!("Path as str: {}", path_str);
    }
    
    // 判断路径是否存在
    let exists = path.exists();
    println!("Path exists: {}", exists);
    
    // 判断是否是文件
    let is_file = path.is_file();
    println!("Is file: {}", is_file);
    
    // 判断是否是目录
    let is_dir = path.is_dir();
    println!("Is directory: {}", is_dir);
}

通过这些方法，PathBuf 提供了强大的路径操作能力，使得文件路径的处理变得更加便捷和高效。