pathlib在Python 3.12中性能显著提升且更鲁棒，推荐全面替代os.path：iterdir()比listdir()快22%，glob()避免重复stat调用，/运算符替代join()，read_text()开销降35%，distutils已移除，应全程使用Path对象。
pathlib 在 Python 3.12 中不是“新”模块，但它已深度受益于底层优化，实际使用中比 3.10/3.11 更快、更稳、更少出错。你不需要重写逻辑，只要把 os.path 替换为 pathlib.Path，就能自动获得加速和跨平台鲁棒性。
pathlib.Path.iterdir() 比 os.listdir() 快 22%，但别在循环里调用 stat()
在遍历目录时，Path.iterdir() 默认不触发 stat() 调用，而 os.listdir() + 后续 os.path.isdir() 或 os.path.getsize() 会强制多次系统调用。
常见错误是写成这样：
for p in Path("data").iterdir():
if p.is_dir(): # 这里隐式调用 stat()
...
如果你只需要过滤类型，改用 Path.glob() 更高效：
-
list(Path("data").glob("*/"))—— 只取子目录，一次系统调用完成 -
list(Path("data").glob("*.log"))—— 只取日志文件，避免逐个判断后缀 - 注意：
glob()返回的是Path对象，不是字符串，直接调用.open()或.read_text()即可
os.path.join() 应该被 Path / 运算符完全替代
os.path.join() 是字符串拼接，不校验路径合法性，也不处理末尾斜杠歧义；而 Path 的 / 运算符是类型安全的，且自动归一化分隔符。
立即学习“Python免费学习笔记（深入）”；
错误写法（尤其在 Windows 上易出错）：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
os.path.join("logs", "2024", "error.txt") # 可能返回 logs\2024\error.txt（反斜杠）
os.path.join("logs/", "2024", "error.txt") # 结果可能含双斜杠 logs//2024/error.txt
正确写法：
-
Path("logs") / "2024" / "error.txt"→ 统一为正斜杠（Linux/macOS）或自动转义（Windows） -
Path("logs") / Path("2024/error.txt")→ 支持嵌套Path，类型一致 - 如果路径来自用户输入，先用
Path(user_input).resolve()防止../跳出预期目录
open() + pathlib.Path.read_text() 在 3.12 中开销降低 35%
Python 3.12 优化了 Path.open() 和 Path.read_text() 的初始化路径，尤其在批量读小文件（如配置、日志行、JSON 片段）时感知明显。
对比：
- 旧方式：
with open(str(p), encoding="utf-8") as f: f.read()—— 多一次str()转换 + 手动编码声明 - 新方式：
p.read_text(encoding="utf-8")—— 自动处理 BOM、换行符标准化，且 3.12 内部跳过冗余缓冲区检查 - 注意：若显式传
encoding=None或errors="surrogateescape"，会绕过优化路径，退回到通用逻辑
distutils 已彻底移除，pathlib 是唯一推荐的路径构建方案
Python 3.12 彻底删除了 distutils，而它曾是很多老项目中构建路径、打包元数据的“惯用路径工具”。现在所有路径组装、包内资源定位都应基于 pathlib：
- 获取当前模块所在目录：
Path(__file__).parent（不是os.path.dirname(__file__)） - 读取同级 data 文件：
Path(__file__).parent / "data" / "config.yaml" - 动态导入资源时，用
importlib.resources.files("mypkg").joinpath("data/icon.png")（返回Path对象） - 不要再依赖
distutils.util.get_platform()或distutils.sysconfig.get_python_lib()—— 它们已不存在
真正容易被忽略的一点：3.12 的 Path 加速只在“干净路径操作”下生效。一旦混用 str(p)、os.fspath(p) 或手动拼接字符串，就退出了优化路径。路径对象该用到底，别半途 cast 成字符串。
