Python文件路径处理_pathlib使用指南

用 pathlib 处理文件路径，比拼接字符串或调用 os.path 更直观、更安全，也更符合现代 python 风格。它把路径当作对象来操作，支持链式调用和面向对象语法，跨平台兼容性好，代码可读性高。

创建和解析路径对象

用 Path 类直接构造路径，自动适配操作系统分隔符（windows 用 ，unix/macos 用 /）：

• from pathlib import Path
• p = Path("data") / "raw" / "input.csv" —— 使用 / 运算符拼接，清爽自然
• p = Path.home() / "Documents" / "report.txt" —— 支持常用快捷属性
• p.resolve() 获取绝对路径（自动处理 .. 和 .）
• p.stem 返回不带后缀的文件名，p.suffix 返回扩展名，p.parent 返回上一级目录

遍历与查找文件

不再需要 os.walk 或嵌套 glob，pathlib 提供简洁的迭代接口：

• p.iterdir() 遍历当前目录下所有子项（仅一层，不递归）
• p.glob("*.py") 匹配当前层级的通配文件
• p.rglob("**/*.log") 递归查找所有 .log 文件（** 表示任意深度）
• 结果是生成器，可直接用于 for 循环：for py_file in Path("src").rglob("*.py"): print(py_file.name)

读写文件与目录操作

内置方法覆盖常见 I/O 场景，无需额外打开/关闭（适合小文件）：

立即学习“Python免费学习笔记（深入）”；

• p.read_text(encoding="utf-8") 读取文本内容
• p.write_text("hello world", encoding="utf-8") 写入文本（自动创建父目录需手动处理）
• p.mkdir(parents=True, exist_ok=True) 创建目录，parents=True 支持多级创建
• p.exists()、p.is_file()、p.is_dir() 判断类型和存在性
• p.rename(Path("new_name.txt")) 或 p.replace(...) 重命名/替换

路径拼接与跨平台注意事项

避免用字符串加法或 os.sep 拼路径 —— 容易出错且难维护：

• 错误写法："data" + os.sep + "config.json" 或 "dataconfig.json"
• 正确写法：Path("data") / "config.json"，/ 运算符会自动转换分隔符
• 相对路径转绝对路径：用 p.absolute() 或 p.resolve()（后者还会检查是否存在并展开符号链接）
• 获取脚本所在目录：Path(__file__).parent，比 os.path.dirname(__file__) 更清晰

pathlib 不是万能的（比如大文件流式读写仍推荐 open()），但对绝大多数路径构建、查询、简单 I/O 场景，它是更现代、更可靠的选择。