pathlib模块简介 - Python路径操作入门指南

一、概述

pathlib 是 Python 3.4+ 引入的面向对象路径操作模块，提供了一种更加 Pythonic 的方式来处理文件系统路径。与传统的 os.path 模块不同，pathlib 将路径封装为 Path 对象，通过面向对象的 API 进行路径操作，代码更加简洁、可读。

pathlib 支持路径拼接、属性访问、文件系统操作（创建、删除、遍历）、文件读写等几乎所有路径相关操作，是现代 Python 开发中处理路径的首选方案。

二、语法与核心类

使用 pathlib 模块前，需要先导入。以下是几种常见的导入方式：

# 导入整个模块
import pathlib

# 导入 Path 类（最常用）
from pathlib import Path

# 使用 Path 创建路径对象
p = Path('some/path')
p = Path.cwd()       # 当前工作目录
p = Path.home()      # 用户主目录

pathlib 核心类

三、Path常用方法与属性

四、代码示例

示例1：基本导入与路径创建

from pathlib import Path

# 创建路径对象
p1 = Path('docs/notes.txt')
p2 = Path('/usr/local/bin')
p3 = Path('C:/Users/Admin/Desktop')

# 获取特殊目录
print(f"当前目录: {Path.cwd()}")
print(f"主目录: {Path.home()}")

# 输出：
# 当前目录: e:\WorkTools\AutoCode\workspace3
# 主目录: C:\Users\Admin

示例2：路径属性访问

from pathlib import Path

p = Path('docs/notes.txt')

print(f"文件名: {p.name}")
print(f"文件名（无后缀）: {p.stem}")
print(f"后缀: {p.suffix}")
print(f"父目录: {p.parent}")
print(f"路径部分: {p.parts}")

# 输出：
# 文件名: notes.txt
# 文件名（无后缀）: notes
# 后缀: .txt
# 父目录: docs
# 路径部分: ('docs', 'notes.txt')

示例3：路径拼接与操作

from pathlib import Path

# 使用 / 运算符拼接路径
base = Path('/home/user')
full_path = base / 'documents' / 'report.pdf'
print(f"拼接路径: {full_path}")

# 链式调用
config_path = Path.home() / '.config' / 'myapp' / 'settings.json'
print(f"配置路径: {config_path}")

# 修改后缀
data_file = Path('data.csv')
new_file = data_file.with_suffix('.json')
print(f"修改后缀: {data_file} -> {new_file}")

# 输出：
# 拼接路径: /home/user/documents/report.pdf
# 配置路径: C:\Users\Admin\.config\myapp\settings.json
# 修改后缀: data.csv -> data.json

五、实际应用场景

• 项目路径管理：使用 Path 对象管理项目中的配置文件、数据文件、日志文件等路径

• 跨平台路径处理：Path 自动适应不同操作系统的路径分隔符，无需手动处理

• 文件系统操作：创建目录、遍历文件、读写文件，全部通过 Path 对象完成

六、注意事项

注意1：pathlib 在 Python 3.4 中引入，3.6 版本后得到全面增强。如果需要兼容更早版本，请使用 os.path。

注意2：Path 对象的 / 运算符只能用于 Path 与字符串或 Path 之间，不能直接与数字等类型使用。

注意3：Path 对象是不可变的，所有操作都返回新的 Path 对象，不会修改原始对象。

提示：PEP 519（Python 3.6+）使得 Path 对象可以直接传给 open() 等内置函数，无需转换为字符串。

七、pathlib与os.path对比

八、小结

• pathlib 提供面向对象的路径操作 API，是现代 Python 的推荐方式

• Path 是最常用的类，自动适应操作系统

• 支持 / 运算符拼接路径，链式调用简洁优雅

• 逐步替代 os.path，成为路径操作的标准方案

九、练习题

十、小贴士