Python内置库：pathlib模块详解

1. 概述

Pathlib模块提供了表示文件系统路径的类，其语义适用于不同的操作系统。路径类分为纯路径和具体路径，前者提供无I/O的纯计算操作，后者继承纯路径，但也提供I/O操作。

2. 与os模块中函数对应关系

下表将各种os模块函数映射到相应的PurePath/Path等价函数。

尽管os.path.relpath（）和PurePath.rerelative_to（）有一些重叠的用例，但它们的语义差异足以保证不认为它们是等效的。

函数具体作用请参考官网： (pathlib — Object-oriented filesystem paths — Python 3.9.17 documentation)

3. pathlib模块内置函数

3.1 获取目录

• Path.cwd(), 返回文件当前所在目录
• Path.home()，返回用户的主目录

from pathlib import Path

current_path = Path.cwd()
home_path = Path.home()
print(f"文件当前所在目录:{current_path }\n用户主目录:{home_path}")

输出： 
文件当前所在目录:E:\CYX_DeepLearning
用户主目录:C:\Users\22799

3.2 目录拼接

from pathlib import Path

parts = ['dataset', '1.txt']

print(Path.cwd())
print(Path.cwd().joinpath(*parts))
print(Path.cwd().parent.joinpath(*parts))
print(Path.cwd().parent.parent.joinpath(*parts))

输出:

E:\CYX_DeepLearning
E:\CYX_DeepLearning\dataset\1.txt
E:\dataset\1.txt
E:\dataset\1.txt

斜杠 / 操作符用于拼接路径

from pathlib import Path

newPath = Path.cwd() / 'python'
print(Path.cwd())
print(f"目录为:{newPath}")

输出;

E:\CYX_DeepLearning
目录为:E:\CYX_DeepLearning\python

3.3 创建、删除目录, 计算相对路径

• Path.mkdir()，创建给定路径的目录。
• Path.rmdir()，删除该目录，目录文件夹必须为空。
• Path.relative_to()，用于获取一个路径相对于另一个基础路径的相对路径。
• Path.unlink() 方法用于删除指定路径所指向的文件或符号链接

from pathlib import Path

# mkdir()方法默认情况下不会创建父级目录。如果你想要创建嵌套的目录结构，你需要设置 parents=True 参数。

# 创建一个名为 "1.txt" 的新目录
path = Path(Path.cwd()/'1.txt')
path.mkdir()

# 也可以使用多级目录路径创建目录
nested_path = Path(Path.cwd()/'3'/'2.txt')
nested_path.mkdir(parents=True)

from pathlib import Path

# 删除一个空目录
path = Path("/path/to/directory")
path.rmdir()

FileNotFoundError: [WinError 3] 系统找不到指定的路径。: '\\path\\to\\directory'

from pathlib import Path

base_path = Path("/home/user")
file_path = Path("/home/user/documents/file.txt")

relative_path = file_path.relative_to(base_path)
print(relative_path)

输出;

documents\file.txt

from pathlib import Path

file_path = Path("/path/to/file.txt")
file_path.unlink()

3.4 读写文件

• Path.open(mode=’r’)，以 “r” 格式打开 Path 路径下的文件，若文件不存在即创建后打开。

• Path.read_bytes()，读取指定路径下的文件，并以文本形式返回文件的内容，等同 open 操作文件的 “rb” 格式。

• Path.read_text()，打开 Path 路径下的文件，以 str 格式读取文件内容，等同 open 操作文件的 “r” 格式。

• Path.write_bytes()，将字节数据写入指定路径下的文件，等同 open 操作文件的 “wb” 格式。

• Path.write_text()，将文本内容写入指定路径下的文件。，等同 open 操作文件的 “w” 格式。

from pathlib import Path

file_path = Path("/path/to/file.txt")

# 以只读模式打开文件
file_obj = file_path.open()

# 以写入模式打开文件
file_obj = file_path.open(mode='w')

# 以追加模式打开文件
file_obj = file_path.open(mode='a')

with file_path.open(mode='w') as file_obj:
    file_obj.write("这是要写入的句子。\n")
    file_obj.write("这是第二个句子。\n")

from pathlib import Path

# 读取文件内容并返回字符串
file_path = Path("/path/to/file.txt")
file_content = file_path.read_text()

# 输出文件所有内容
print(file_content)

from pathlib import Path

# 将字节数据写入文件
file_path = Path("./1.txt")
data = b"Hello, world!"  # 字节数据
file_path.write_bytes(data)

from pathlib import Path

# 将文本写入文件
file_path = Path("/path/to/file.txt")
text = "Hello, world!"  # 文本内容
file_path.write_text(text)

3.5 获取文件所在目录的不同部分字段

• Path.resolve()，通过传入文件名，返回指定路径的绝对路径。
• Path.parts 属性返回路径中不带分隔符的各个部分组成的元组。
• Path.name，属性返回指定路径的基本文件名或目录名，包含后缀名。
• Path.rename()，重命名路径
• Path.parent，属性返回指定路径的父级路径。
• Path.parents 属性返回指定路径的所有父级路径。
• Path.stem，返回指定路径的文件名或目录名的基本名称部分，不包含后缀名。
• Path.suffix，返回指定路径的文件的后缀（扩展名）部分。
• Path.anchor，返回指定路径的根部分或驱动器部分。
• Path.drive，返回驱动器名称。
• Path.root，返回路径的根目录。

from pathlib import Path

file_path = Path("/path/to/file.txt")
print(file_path.parts)

输出：

('\\', 'path', 'to', 'file.txt')

from pathlib import Path

path = Path("/path/to/old_name.txt")
new_path = path.rename("/path/to/new_name.txt")

print(new_path)  # 输出：/path/to/new_name.txt

3.6 文件、路径是否存在判断

• Path.exists():用于检查指定路径是否存在。
• Path.is_dir():用于检查指定路径是否是一个目录。
• Path.is_file():检查指定路径是否是一个文件。
• Path.is_absolute()，用于检查路径是否为绝对路径。

from pathlib import Path

file_path = Path("/path/to/file.txt")
exists = file_path.exists()

# 输出路径是否存在
print(exists)

3.7 文件统计以及匹配查找

• Path.iterdir():方法返回一个迭代器，用于遍历指定路径下的所有子项（文件和目录）
• Path.glob(pattern)，方法返回一个迭代器，用于匹配指定路径下的文件和目录。
• Path.rglob(pattern)，返回一个递归迭代器，用于递归地匹配指定路径及其子目录下的文件和目录。

from pathlib import Path

# 只返回该文件夹内的文件和目录
dir_path = Path("/path/to/directory")
for item in dir_path.iterdir():
   print(item)

from pathlib import Path

dir_path = Path("/path/to/directory")
for item in dir_path.glob("*.txt"):
    print(item)

from pathlib import Path

dir_path = Path("/path/to/directory")
for item in dir_path.rglob("*.txt"):
    print(item)

---------------------------END---------------------------

题外话

当下这个大数据时代不掌握一门编程语言怎么跟的上脚本呢？当下最火的编程语言Python前景一片光明！如果你也想跟上时代提升自己那么请看一下.

感兴趣的小伙伴，赠送全套Python学习资料，包含面试题、简历资料等具体看下方。


👉CSDN大礼包🎁：全网最全《Python学习资料》免费赠送🆓！（安全链接，放心点击）

一、Python所有方向的学习路线

Python所有方向的技术点做的整理，形成各个领域的知识点汇总，它的用处就在于，你可以按照下面的知识点去找对应的学习资源，保证自己学得较为全面。

二、Python必备开发工具

工具都帮大家整理好了，安装就可直接上手！

三、最新Python学习笔记

当我学到一定基础，有自己的理解能力的时候，会去阅读一些前辈整理的书籍或者手写的笔记资料，这些笔记详细记载了他们对一些技术点的理解，这些理解是比较独到，可以学到不一样的思路。

四、Python视频合集

观看全面零基础学习视频，看视频学习是最快捷也是最有效果的方式，跟着视频中老师的思路，从基础到深入，还是很容易入门的。

五、实战案例

纸上得来终觉浅，要学会跟着视频一起敲，要动手实操，才能将自己的所学运用到实际当中去，这时候可以搞点实战案例来学习。

六、面试宝典

简历模板

👉 CSDN大礼包:gift:：[全网最全《Python学习资料》免费赠送:free:！](https://blog.csdn.net/weixin_68789096/article/details/132275547?spm=1001.2014.3001.5502) （安全链接，放心点击）

若有侵权，请联系删除