Python 中 pathlib 和 os.path 有什么区别？为什么现在更推荐 pathlib？

简化版

os.path 是函数式路径处理 API，操作的是字符串；pathlib 是面向对象路径 API，操作的是 Path 对象。pathlib 可读性更好、跨平台拼路径更自然，还能直接读写文件、判断存在、遍历目录，因此现代 Python 项目更推荐优先使用 pathlib。

详细版

对比示例：

import os

path = os.path.join("data", "users", "a.txt")
print(os.path.exists(path))
print(os.path.basename(path))

from pathlib import Path

path = Path("data") / "users" / "a.txt"
print(path.exists())
print(path.name)

pathlib 的优势：

用 / 拼接路径，避免手写分隔符；
Path 对象有清晰属性，如 name、suffix、stem、parent；
支持 read_text()、write_text()、iterdir()、glob() 等常用操作；
跨平台处理 Windows 和 POSIX 路径更自然；
很多标准库 API 可以直接接收 path-like object。

os.path 仍然可用，老项目和底层兼容代码中很常见。面试回答可以说：新代码优先 pathlib，维护旧代码时理解 os.path。

完整版教学

一、路径处理为什么不能手动拼字符串

很多初学者会这样写：

path = "data/" + filename

这在简单 Linux 环境下可能可用，但一旦遇到 Windows 分隔符、重复斜杠、绝对路径、上级目录、文件名为空等情况，就容易出问题。

路径不是普通字符串，它有自己的结构：

盘符或根路径；
父目录；
文件名；
后缀；
相对路径和绝对路径；
符号链接和真实路径。

所以应该使用标准库处理路径，而不是手写字符串拼接。

二、os.path 是函数式风格

os.path 提供很多函数：

import os

path = os.path.join("logs", "app.log")
print(os.path.abspath(path))
print(os.path.dirname(path))
print(os.path.basename(path))
print(os.path.splitext(path))

它的特点是简单直接，历史悠久，兼容性好。很多旧代码都会使用 os.path。

缺点是路径本身仍然是字符串，相关操作分散在不同函数中。链式处理时可读性一般。

三、pathlib 是面向对象风格

pathlib 把路径建模成对象：

from pathlib import Path

path = Path("logs") / "app.log"

print(path.resolve())
print(path.parent)
print(path.name)
print(path.stem)
print(path.suffix)

这种写法更接近“对路径这个对象做操作”。Path 还能直接做文件操作：

path.write_text("hello", encoding="utf-8")
text = path.read_text(encoding="utf-8")

遍历目录也很清晰：

for file in Path("logs").glob("*.log"):
    print(file.name)

四、pathlib 的跨平台价值

不同系统路径风格不同：

Windows: C:\Users\alice\data.txt
Linux:   /home/alice/data.txt

Path("data") / "users" / "a.txt" 会按当前系统生成合适路径。代码不需要关心分隔符是 / 还是 \。

这不是说路径问题全自动消失。比如大小写敏感、权限模型、符号链接行为仍可能和操作系统有关。但至少路径拼接、拆分、后缀处理不需要手写。

五、Path 对象和字符串的兼容

现代 Python 标准库中很多文件 API 可以接收 path-like object：

from pathlib import Path

path = Path("data.txt")
with open(path, "r", encoding="utf-8") as f:
    print(f.read())

如果遇到第三方库只接受字符串，可以显式转换：

str(path)

不要过早把所有 Path 都转成字符串，否则会损失 pathlib 的表达力。

六、常见误区与追问

记忆钩子：os.path 是一组函数，pathlib.Path 是路径对象。新代码优先 Path，不是因为更潮，而是因为路径操作能链式表达、跨平台更清楚。

误区：路径拼接用字符串加斜杠就行。 Windows 和 POSIX 分隔符不同，手写拼接容易出现重复斜杠、漏分隔符、转义字符问题；应使用 Path / "child" 或 os.path.join。
追问：Path 对象能不能传给老 API？ 大多数现代标准库和第三方库支持 path-like 对象；不支持时可以用 str(path) 显式转换。
误区：Path.resolve() 和字符串规范化完全一样。 resolve() 会解析绝对路径并处理符号链接等情况；是否要求路径存在、是否解析链接，要看具体版本和参数。
追问：Path.cwd() 和 Path(__file__) 适合什么场景？ cwd() 是当前工作目录，受启动位置影响；__file__ 更适合定位当前脚本附近的资源文件。
误区：pathlib 会自动解决所有跨平台问题。 它能处理分隔符和路径对象模型，但大小写敏感、权限、保留文件名、符号链接等差异仍要按平台理解。
追问：维护老项目时是否要全部改成 pathlib？ 不一定。新模块可以优先 pathlib；老代码如果大量使用 os.path 且稳定，渐进迁移比一次性重写更稳。

七、加强记忆

os.path 是“拿字符串调函数”，pathlib 是“拿路径对象调方法”。新代码里优先用 Path，用 / 拼路径，用 .name、.suffix、.parent 拿结构信息；遇到老代码或兼容场景再使用 os.path。路径处理不要手写字符串，这是最重要的工程习惯。

简化版

详细版