文章目录
- 6.2 模式匹配查找 (`glob` 与 `rglob`)
一、 引言：为什么需要 pathlib？
你是否还在为拼接文件路径时写满反斜杠和 os.path.join 而感到烦恼？是否曾因 \t 被误认为制表符而导致路径错误？在 Python 中，传统的 os.path 模块虽然功能强大，但 API 零散、字符串操作繁琐，且在不同操作系统上行为不一致。
本文要解决的问题：提供一个现代化、面向对象、跨平台的路径操作解决方案——pathlib 标准库。
你将获得的收益：
- 代码更优雅
- 操作更安全
- 功能更集成：将创建、删除、遍历、读写等操作封装在单一对象中。
- 理解更深入
下面，让我们从一次真实的“踩坑”经历开始。
二、 从一次“踩坑”说起：路径字符串的陷阱
很多人以为在 Windows 上写路径 ".\test.txt" 和 "./test.txt" 是等价的，但其实不然。\t 在字符串中是一个转义序列（制表符）。
我实际遇到的场景：在一次数据预处理脚本中，我使用 Path(".\data\raw\train.csv") 来构建路径，程序没有报错，但后续的 exists() 检查始终返回 False。调试后发现，打印出的路径变成了 . aw\train.csv，\t 被解释为了制表符，导致路径完全错误。
解决过程：我立刻意识到是转义字符问题。解决方案有三种：
- 使用正斜杠
/：Path("./data/raw/train.csv")（pathlib 会自动转换）。 - 使用原始字符串：
Path(r".\data\raw\train.csv")。 - 对反斜杠进行转义：
Path(".\\data\\raw\\train.csv")。
教训：强烈建议在构造 Path 对象时，统一使用正斜杠 / 作为路径分隔符。这是 pathlib 跨平台设计的核心优势之一，代码在 Windows、Linux、macOS 上都能正确运行。
三、 核心概念：理解 Path 对象
3.1 Path 是什么？
Path 是 pathlib 模块的核心类，它是一个表示文件系统路径的纯对象。它本身不执行任何磁盘 I/O 操作（如创建文件），只是对路径进行描述和操作。其设计遵循了“面向对象”和“流畅接口”原则，让路径操作像链式调用一样自然。
from pathlib import Path # 第一步：导入Path类# 创建一个Path对象，它只是“代表”这个路径，文件可以不存在path_obj = Path("/userTest/myPath.txt")print(f"路径对象: {path_obj}, 类型: {type(path_obj)}")# 输出示例（Windows）: 路径对象: \userTest\myPath.txt, 类型: <class 'pathlib.WindowsPath'>
代码解释：
from pathlib import PathPath("/userTest/myPath.txt")：用字符串构造一个 Path 对象。这里的 / 是 POSIX 风格，pathlib 在内部会根据当前操作系统自动转换为合适的格式（Windows 会转换成 \）。- 打印结果显示了对象的内部表示和类型（
WindowsPath 或 PosixPath）。
3.2 获取常用路径
在开始操作前，我们经常需要获取一些基准路径。
# 获取当前用户的主目录（Home Directory）home_path = Path.home()print(f"用户主目录: {home_path}")# 输出示例（Windows）: 用户主目录: C:\Users\YourUsername# 获取当前工作目录（Current Working Directory）cwd_path = Path.cwd() # 功能等同于 os.getcwd()print(f"当前工作目录: {cwd_path}")# 输出示例: 当前工作目录: d:\python_code_test
四、 基础操作：拼接、分解与判断
4.1 优雅的路径拼接
告别 os.path.join，使用 / 运算符进行路径拼接，这是 pathlib 最直观的优点。
base_path = Path("/userTest")file_path = base_path / "data" / "file.txt" # 使用 / 运算符拼接print(f"拼接后的路径: {file_path}")# 输出: 拼接后的路径: \userTest\data\file.txt
为什么可以这样用？Path 类重载了 / 运算符（__truediv__ 方法），使其专门用于路径拼接，返回一个新的 Path 对象。这比字符串拼接更安全、更易读。
4.2 分解路径属性
你可以轻松获取路径的各个组成部分，而无需使用 os.path.splitext 或字符串切片。
example_path = Path("/userTest/data/archive.tar.gz")# 获取文件名（包含后缀）print(f"文件名: {example_path.name}") # 输出: archive.tar.gz# 获取主文件名（不含后缀）print(f"主文件名: {example_path.stem}") # 输出: archive.tar# 获取后缀（最后一个点之后的部分）print(f"文件后缀: {example_path.suffix}") # 输出: .gz# 获取所有后缀（适用于多重扩展名）print(f"所有后缀: {example_path.suffixes}") # 输出: ['.tar', '.gz']# 获取父目录print(f"父目录: {example_path.parent}") # 输出: \userTest\data
技术深度：.suffix 和 .suffixes 的区别体现了设计者对常见用例的考量。对于简单的 .txt 文件，.suffix 足够；对于打包压缩文件 .tar.gz，.suffixes 提供了更精细的控制。
4.3 路径存在性判断
在对路径进行操作前，先判断其是否存在是良好的编程习惯。
real_file = Path("./test.txt")if real_file.exists(): print(f"路径 '{real_file}' 存在。它是一个{'文件'if real_file.is_file() else'目录'}。")else: print(f"路径 '{real_file}' 不存在。")# 判断一个不存在的路径non_existent = Path("./user/found404.html")print(f"路径 '{non_existent}' 存在吗？ {non_existent.exists()}")# 输出: 路径 'user\found404.html' 存在吗？ False
常见误解纠正：is_file() 和 is_dir() 都要求路径真实存在于磁盘。如果路径不存在，两者都返回 False。这就是下面示例中 study.py 被判断为“既不是文件也不是目录”的原因。
def judge_path(obj): """判断路径是文件、目录还是不存在""" path_obj = Path(obj) if path_obj.is_file(): print(f"{path_obj} 是一个文件。") elif path_obj.is_dir(): print(f"{path_obj} 是一个目录。") else: print(f"{path_obj} 既不是文件也不是目录（可能不存在）。")# 假设当前目录下没有 study.py 文件judge_path("./study.py")# 输出: study.py 既不是文件也不是目录（可能不存在）。
解决办法：始终先使用 exists() 检查，或确保你操作的路径是正确的。
五、 文件系统操作：增删改查
5.1 创建目录和文件
# 1. 创建目录（支持递归创建）new_dir = Path("new_project/src/utils")new_dir.mkdir(parents=True, exist_ok=True)# parents=True: 自动创建不存在的父目录。# exist_ok=True: 如果目录已存在，不抛出FileExistsError。# 2. 创建空文件new_file = Path("new_project/README.md")new_file.touch(exist_ok=True) # exist_ok=True 防止文件已存在时报错
5.2 重命名与移动文件
rename() 方法非常强大，不仅可以重命名，还可以移动文件到其他目录。
source = Path("./test.txt")destination = Path("./archive/renamed_test.txt")# 如果 archive 目录不存在，需要先创建，或者使用 parents=Truedestination.parent.mkdir(parents=True, exist_ok=True)source.rename(destination)print(f"文件已移动/重命名为: {destination}")
原理说明：rename() 在底层调用了操作系统的重命名系统调用。如果目标路径位于不同的文件系统（挂载点），某些操作系统可能会先复制再删除，但这对于 pathlib 用户是透明的。
5.3 删除文件与目录
# 1. 删除文件 (类似 os.remove)file_to_delete = Path("./temp_file.txt")if file_to_delete.exists(): file_to_delete.unlink() # 删除文件 print(f"已删除文件: {file_to_delete}")# 2. 删除空目录 (类似 os.rmdir)empty_dir_to_delete = Path("./empty_folder")if empty_dir_to_delete.exists() and empty_dir_to_delete.is_dir(): empty_dir_to_delete.rmdir() # 只能删除空目录 print(f"已删除空目录: {empty_dir_to_delete}")# 注意：删除非空目录需要使用 shutil.rmtree，pathlib 本身不提供此功能。
六、 高级遍历与文件查找
pathlib 提供了比 os.walk 更直观的遍历方法。
6.1 遍历目录内容 (iterdir)
project_root = Path("./python_code_test")# 创建示例目录结构(project_root / "src").mkdir(exist_ok=True)(project_root / "docs").mkdir(exist_ok=True)(project_root / "docs/input.txt").touch(exist_ok=True)print("遍历项目根目录:")for item in project_root.iterdir(): # iterdir() 返回一个生成器，节省内存 print(f" - {item.name} ({'目录'if item.is_dir() else'文件'})")# 输出示例:# - src (目录)# - docs (目录)
6.2 模式匹配查找 (glob 与 rglob)
这是 pathlib 的杀手锏之一，用于查找匹配特定模式的文件。
# 1. glob: 在当前目录下非递归查找print("查找当前目录下所有 .txt 文件:")for txt_file in project_root.glob("*.txt"): # 模式匹配 print(f" - {txt_file}")# 2. rglob: 递归查找当前目录及其所有子目录print("\n递归查找所有 .py 文件:")for py_file in project_root.rglob("*.py"): # 递归模式匹配 print(f" - {py_file}")
根据 glob 原理，给出一个推断性建议：glob 模式中的 * 和 ** 非常强大。* 匹配单层任意字符，** 匹配任意多层目录。例如，**/*.py 可以递归匹配所有 Python 文件。但在包含大量文件的目录中使用 rglob('**/*') 需谨慎，可能效率较低，可以考虑结合 os.scandir 进行性能优化。
七、 文件读写简化
pathlib 提供了快捷方法进行小文件的读写。
# 写入文本config_file = Path("./config.json")config_content = '{"language": "python", "version": 3.9}'config_file.write_text(config_content, encoding="utf-8") # 默认覆盖写入print("配置已写入。")# 读取文本try: content = config_file.read_text(encoding="utf-8") print(f"读取的内容: {content}")except FileNotFoundError: print("文件不存在。")
注意：write_text 和 read_text 适合处理内容不多的文本文件。对于大文件或二进制文件，建议仍然使用 with open(file_path, 'rb') as f: 的传统方式。
八、 总结与讨论
核心收获
- 面向对象，代码优雅：
Path 对象将路径实体化，/ 运算符使拼接直观，方法链让操作流畅。 - 安全跨平台：统一使用
/ 可避免转义错误，库自动处理系统差异。 - 功能集成度高：从路径解析、存在判断到文件创建、遍历查找，常用操作一站式解决。
- 替代 os.path：对于大多数路径操作场景，
pathlib 是更现代、更推荐的选择。
一个开放性问题
你在实际项目中是从 os.path 迁移到 pathlib 的，还是一开始就使用了 pathlib？在迁移或使用过程中，遇到的最大挑战或带来的最大效率提升是什么？欢迎在评论区分享你的经验！
