Python / 系统课时

用 pathlib 处理文件路径

用 pathlib 处理文件路径

在不同操作系统中直接拼接文件路径容易产生分隔符、目录判断和路径转换问题。本篇将学习 pathlib 的核心用法,使用 Path 对象安全地表示、检查和创建文件路径,让文件操作代码更稳定。

学习目标

  • 理解 pathlib 解决传统字符串路径处理问题的方式。
  • 掌握 Path 创建、拼接、检查和创建目录的方法。
  • 能在实际文件读写场景中使用 pathlib 组织路径。

使用 Path 对象表示路径

Python 早期常使用字符串和 os.path 处理路径,例如通过拼接字符串生成文件位置。这种方式需要开发者关注不同系统的路径分隔符,而 pathlib 将路径抽象成对象,由 Python 负责处理平台差异。

Path 对象可以直接表示文件或目录,并提供判断、遍历、创建等方法。路径本身不会立即访问磁盘,只有调用相关操作时才会真正影响文件系统。

拼接和检查文件路径

pathlib 使用 / 运算符组合路径,比字符串拼接更直观。下面示例创建一个工作目录路径,检查文件是否存在,并读取文件内容。

python
from pathlib import Path

# Path 会根据当前操作系统生成正确的路径形式
config_file = Path("project") / "config" / "settings.txt"

if config_file.exists() and config_file.is_file():
    content = config_file.read_text(encoding="utf-8")
    print(content)
else:
    print("配置文件不存在")

预期输出

text
配置文件不存在

实际运行时,如果 project/config/settings.txt 存在,则输出文件中的文本内容;不存在时输出提示信息。

常用检查方法包括:

方法 作用
exists() 判断路径是否存在
is_file() 判断是否为文件
is_dir() 判断是否为目录

创建目录和管理路径

在生成日志、缓存或导出文件时,程序通常需要提前创建目录。Path 提供了 mkdir() 方法,可以创建单级或多级目录。

python
from pathlib import Path

output_dir = Path("output") / "reports"
output_dir.mkdir(parents=True, exist_ok=True)

report_file = output_dir / "daily.txt"
report_file.write_text("report generated", encoding="utf-8")

print(report_file)

预期输出

text
output/reports/daily.txt

parents=True 表示父目录不存在时一起创建,exist_ok=True 表示目录已经存在时不抛出异常。

pathlib 的适用场景

在命令行工具、批处理脚本和项目配置管理中,路径处理通常贯穿整个程序。使用 pathlib 可以减少字符串操作错误,让代码更接近实际文件结构。

需要注意的是,Path 负责描述路径和执行文件系统操作,但不会替代文件权限管理、锁机制等更底层能力。在复杂文件同步或并发写入场景中,仍需要额外设计。

当代码需要跨平台运行,或者需要频繁组合、判断文件路径时,优先选择 pathlib;如果只是处理简单字符串,不涉及文件系统操作,普通字符串即可满足需求。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 pathlib 处理文件路径

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

登录哪都通