
用 pathlib 处理文件路径,比拼接字符串或调用 os.path 更直观、更安全,也更符合现代 Python 风格。它把路径当作对象来操作,支持链式调用和面向对象语法,跨平台兼容性好,代码可读性高。
创建和解析路径对象
用 Path 类直接构造路径,自动适配操作系统分隔符(Windows 用 ,Unix/macOS 用 /):
from pathlib import Path-
p = Path("data") / "raw" / "input.csv"—— 使用/运算符拼接,清爽自然 -
p = Path.home() / "Documents" / "report.txt"—— 支持常用快捷属性 -
p.resolve()获取绝对路径(自动处理..和.) -
p.stem返回不带后缀的文件名,p.suffix返回扩展名,p.parent返回上一级目录
遍历与查找文件
不再需要 os.walk 或嵌套 glob,pathlib 提供简洁的迭代接口:
-
p.iterdir()遍历当前目录下所有子项(仅一层,不递归) -
p.glob("*.py")匹配当前层级的通配文件 -
p.rglob("**/*.log")递归查找所有.log文件(**表示任意深度) - 结果是生成器,可直接用于
for循环:for py_file in Path("src").rglob("*.py"): print(py_file.name)
读写文件与目录操作
内置方法覆盖常见 I/O 场景,无需额外打开/关闭(适合小文件):
立即学习“Python免费学习笔记(深入)”;
-
p.read_text(encoding="utf-8")读取文本内容 -
p.write_text("hello world", encoding="utf-8")写入文本(自动创建父目录需手动处理) -
p.mkdir(parents=True, exist_ok=True)创建目录,parents=True支持多级创建 -
p.exists()、p.is_file()、p.is_dir()判断类型和存在性 -
p.rename(Path("new_name.txt"))或p.replace(...)重命名/替换
路径拼接与跨平台注意事项
避免用字符串加法或 os.sep 拼路径 —— 容易出错且难维护:
- 错误写法:
"data" + os.sep + "config.json"或"data\config.json" - 正确写法:
Path("data") / "config.json",/运算符会自动转换分隔符 - 相对路径转绝对路径:用
p.absolute()或p.resolve()(后者还会检查是否存在并展开符号链接) - 获取脚本所在目录:
Path(__file__).parent,比os.path.dirname(__file__)更清晰
pathlib 不是万能的(比如大文件流式读写仍推荐 open()),但对绝大多数路径构建、查询、简单 I/O 场景,它是更现代、更可靠的选择。










