4.1 路径与文件 I/O:告别 os.path,全面拥抱面向对象路径库 pathlib
本节目录
欢迎回到 HelloWorld 技术社区(www.helloworld.net) 《Python 现代开发实战》专栏。
在早期 Python 代码里,处理文件路径满屏都是 os.path.join(os.path.dirname(os.path.abspath(__file__)), "data", "config.json") 这样层层嵌套的“洋葱式代码”。不仅写起来冗长,一旦跨 Windows(反斜杠 \)和 Linux(正斜杠 /)部署,极易因为硬编码路径分隔符引发线上报错。
自 Python 3.4 引入标准库 pathlib 以来,路径不再是脆弱的字符串,而是拥有丰富方法的面向对象 Path 实例。在现代 Python 工程中,一条铁律是:新代码全面弃用 os.path,100% 拥抱 pathlib。
一、 Path 对象的现代操作姿势
pathlib 最惊艳的设计之一,是重载了除法运算符 /,让路径拼接变得像写自然语言一样直观,并且自动适配当前操作系统的路径分隔符:
from pathlib import Path
# 1. 获取当前脚本所在目录与用户主目录
current_dir = Path(__file__).resolve().parent
home_dir = Path.home()
# 2. 使用 / 运算符优雅拼接路径(自动跨平台兼容)
log_file = current_dir / "logs" / "2026" / "app_error.log"
# 3. 路径属性拆解(无需再记忆 os.path.splitext / basename)
print("完整文件名:", log_file.name) # app_error.log
print("纯文件名: ", log_file.stem) # app_error
print("扩展名: ", log_file.suffix) # .log
print("父级目录: ", log_file.parent) # .../logs/2026
# 4. 自动创建多级父目录(parents=True 相当于 mkdir -p,exist_ok=True 防止已存在报错)
log_file.parent.mkdir(parents=True, exist_ok=True)
二、 极简文件读写与目录递归扫描
对于配置文件、小型文本或二进制文件,Path 直接提供了自带自动关闭句柄(上下文管理)的一行读写方法;而扫描目录下特定后缀文件时,glob 和 rglob(递归扫描子目录)更是神器:
from pathlib import Path
target_file = Path("notes.txt")
# 1. 一行代码安全写入与读取文本(务必显式指定 encoding="utf-8",防止 Windows 默认 GBK 乱码)
target_file.write_text("HelloWorld 社区现代 Python 工程规范\n", encoding="utf-8")
content = target_file.read_text(encoding="utf-8")
# 2. 递归扫描当前目录下所有 .py 文件并统计总行数
py_files = list(Path(".").rglob("*.py"))
total_lines = sum(len(f.read_text(encoding="utf-8").splitlines()) for f in py_files)
print(f"共扫描到 {len(py_files)} 个 Python 文件,总计 {total_lines} 行代码")
工程避坑提示:read_text() 会一次性把整个文件读入内存,仅适合几 MB 以内的配置或中小文本;如果处理几百 MB 以上的日志文件,请务必使用 with target_file.open("r", encoding="utf-8") as f: 逐行流式读取。
💬 HelloWorld 社区实战打卡
请在你的练习目录中,使用 pathlib 编写一段脚本:扫描当前工作目录下所有的 .md 文件,并将它们的文件名、大小(字节数,f.stat().st_size)打印出来。带 #Python专栏打卡 标签发至评论区!