Python pathlib 模块文件与目录操作指南

pathlib 模块概述与对比优势

pathlib 是 Python 3.4 引入的标准库，旨在通过面向对象的方式处理文件系统路径。相较于传统的 os.path 模块，Path 类将路径与方法绑定，支持链式调用与运算符拼接（如 /），代码结构更紧凑，且在处理跨平台路径分隔符时具备天然兼容性。其核心功能覆盖目录管理、路径属性提取、存在性判定、文件流读写以及基于模式的批量查找。

第1步：路径对象初始化与拼接

操作目的：获取当前工作目录、用户主目录，并使用斜杠运算符构建新路径。该操作避免手动拼接字符串导致的反斜杠/正斜杠兼容问题。 入口：命令行终端或 Python 脚本环境。 重要参数：cwd() 返回运行脚本所在目录；home() 返回系统家目录；/ 用于追加子路径。

from pathlib import Path

# 获取当前工作目录与用户主目录
currentPath = Path.cwd()
homePath = Path.home()

# 使用斜杠运算符拼接新路径
new_path = currentPath / 'test'
print(f"文件当前所在目录:{currentPath}")
print(f"用户主目录:{homePath}")
print(f"新目录为:{new_path}")

第2步：目录创建与安全清理

操作目的：按需生成新文件夹并清理指定空目录。 入口：Path 实例方法。 重要参数：mkdir() 默认不会递归创建父目录，若父级不存在会抛出 FileNotFoundError，生产环境建议配合 parents=True 与 exist_ok=True；rmdir() 仅允许删除空文件夹，非空时将触发异常。

currentPath = Path.cwd()
# 创建子目录
makePath = currentPath / 'generated_dir'
makePath.mkdir(exist_ok=True)
print(f"创建的目录为:{makePath}")

# 清理空目录
delPath = currentPath / 'empty_dir'
delPath.rmdir()
print(f"成功删除空目录:{delPath}")

第3步：解析路径字段与元数据提取

操作目的：快速分离文件名、后缀、上级目录及磁盘锚点，便于日志记录或动态路由生成。 入口：Path 对象的只读属性与 resolve() 方法。 重要参数：resolve() 返回绝对路径并自动去除相对符号；name 含后缀；stem 不含后缀；parent 指向直接父级；suffix 获取扩展名；anchor 返回根目录或盘符标识。

txtPath = Path('data/report.csv')
full_path = txtPath.resolve()

print(f"文件的完整路径为:{full_path}")
print(f"文件完整名称(含后缀):{full_path.name}")
print(f"纯文件名(去后缀):{full_path.stem}")
print(f"文件后缀名为:{full_path.suffix}")
print(f"所在的文件夹名:{full_path.parent}")
print(f"文件所在的盘符/根目录:{full_path.anchor}")

第4步：验证文件与目录状态

操作目的：在执行读写或删除操作前进行预判，防止程序因路径缺失或类型不符崩溃。 入口：exists()、is_dir()、is_file() 均返回布尔值。 注意：这些方法在多线程环境下存在竞态条件风险，建议在实际操作时捕获异常而非单纯依赖布尔判断。

targetDir = Path.cwd() / 'workspace'
targetFile = Path.cwd() / 'input.txt'

print(targetDir.exists())   # 检查路径是否存活
print(targetDir.is_dir())   # 确认是否为目录
targetDir.mkdir(exist_ok=True)

print(targetFile.exists())  # 文件未创建时返回 False
print(targetFile.is_file()) 

# 创建测试文件以便后续演示
with targetFile.open('w') as f:
    f.write('sample')

print(targetFile.exists())  # 返回 True
print(targetFile.is_file()) # 返回 True

第5步：标准化文件读写流程

操作目的：替代冗长的 open() + close() 模板，提供直接的文本与二进制流读写接口。 入口：read_text()、write_text() 对应文本模式；read_bytes()、write_bytes() 对应字节模式。

# 文本写入与读取
mkPathText = Path.cwd() / 'output.txt'
mkPathText.write_text('Hello pathlib')
print(f"读取的文件内容为:{mkPathText.read_text()}")

# 二进制流处理
str_data = bytes('binary_test', encoding='utf-8')
mkPathByte = Path.cwd() / 'dump.bin'
mkPathByte.write_bytes(str_data)
print(f"读取的字节内容为:{mkPathByte.read_bytes()}")

第6步：目录遍历与模式匹配查找

操作目的：在复杂工程结构中快速定位特定格式文件，常用于数据集清洗或资源统计。 入口：iterdir() 列出同级全部条目；glob(pattern) 支持一级匹配；rglob(pattern) 递归遍历子目录。

import pathlib
from collections import Counter

currentPath = pathlib.Path.cwd()

# 遍历当前目录统计后缀分布
gen_all = (i.suffix for i in currentPath.iterdir() if i.is_file())
print(f"当前目录文件后缀分布:{Counter(gen_all)}")

# glob 匹配 .log 文件
gen_txt = (i.suffix for i in currentPath.glob('*.log'))
print(f"顶层 .log 文件分布:{Counter(gen_txt)}")

# rglob 递归查找所有 .md 文档
gen_md = (i.suffix for i in currentPath.rglob('*.md'))
print(f"全局 .md 文件分布:{Counter(gen_md)}")

以上就是 Python pathlib 模块路径拼接文件读写与匹配查找的详细内容，更多关于 Python 文件系统自动化处理的资料请关注本站其它相关文章！