os模块需理解操作系统契约：pathlib比os.path更安全可靠，scandir性能优于listdir，replace实现原子重命名但跨卷受限，open/fdopen可精细控制I/O。
Python 的 os 模块不是“学完就懂”的工具，它底层直接映射操作系统行为，跨平台差异、权限模型、符号链接处理稍有不慎就会出错——尤其在生产环境批量操作文件时。
为什么 os.path.join() 不能替代 pathlib.Path
很多人用 os.path.join() 拼路径，以为只是写法习惯
问题。实际上它不验证路径合法性，也不处理斜杠方向、重复分隔符或相对路径归一化。比如 os.path.join("a//b", "/c") 返回 "/c"（Windows 下可能是 "c"），因为遇到绝对路径就丢弃前面所有部分。
-
pathlib.Path("a//b") / "/c"会抛出ValueError: absolute path，强制你意识到路径语义错误 -
Path("a/b/../c").resolve()能真实解析到目标位置；os.path.normpath()只做字符串归一，不检查是否存在 - 在 Docker 或 CI 环境中，
pathlib的.exists()和.is_file()更可靠，因为它走的是系统调用而非字符串模拟
os.listdir() 和 os.scandir() 的性能与信息差异
os.listdir() 只返回文件名列表，每次判断类型（如是否为目录）都得额外调用 os.path.isdir()，这意味着对每个条目发起一次系统调用。而 os.scandir() 一次性获取完整目录项信息，在循环中直接读取 entry.is_dir() 或 entry.stat().st_size，无额外开销。
- Python 3.7+ 中，
os.walk()默认已用scandir实现，但显式使用仍更可控 -
scandir返回的DirEntry对象缓存了stat结果，多次访问.stat().mtime不触发重复系统调用 - 注意：Windows 上
DirEntry.inode()总是返回 0，Linux/macOS 才有效；跨平台代码别依赖它做去重
for entry in os.scandir("/var/log"):
if entry.is_file() and entry.stat().st_size > 1024*1024:
print(f"{entry.name}: {entry.stat().st_size} bytes")
用 os.replace() 做原子重命名，但要注意平台限制
os.replace(src, dst) 是唯一能保证“替换即生效”的跨平台接口，适用于日志轮转、配置热更新等场景。但它在 Windows 上要求 src 和 dst 必须在同一磁盘分区，否则抛 OSError: [WinError 17]（跨卷不支持原子移动）。
立即学习“Python免费学习笔记（深入）”；
- Linux/macOS 上可跨文件系统，本质是
rename(2)系统调用 - 若需跨卷安全替换，先
shutil.move()再os.unlink()，但中间存在窗口期（旧文件删了、新文件没写完） - 永远不要用
os.rename()替代os.replace()：前者在 Windows 上无法覆盖已存在文件，会报FileExistsError
os.open() + os.fdopen() 是绕过缓冲、控制 close-on-exec 的关键组合
日常用 open() 很方便，但它默认开启缓冲、且 fd 不设 FD_CLOEXEC 标志——子进程继承该 fd 可能导致资源泄露或竞争。真正需要精细控制 I/O 行为（如守护进程日志、socket 文件描述符传递）时，必须下到底层。
-
os.open(path, os.O_WRONLY | os.O_CREAT | os.O_CLOEXEC)直接获取带CLOEXEC的 fd -
os.fdopen(fd, "w", buffering=0)创建无缓冲文件对象，避免print()滞留 - 手动管理 fd 时，务必配对
os.close(fd)，Python 的__del__不保证及时释放
fd = os.open("/tmp/log", os.O_WRONLY | os.O_APPEND | os.O_CLOEXEC)
f = os.fdopen(fd, "w", buffering=0)
f.write("start\n")
f.close() # 注意：这也会关闭底层 fd
真正难的从来不是记住函数名，而是理解每个 API 背后绑定的操作系统契约：什么时候它会阻塞，什么时候会失败而不提示，以及当 NFS、overlayfs、/proc 这类特殊文件系统介入时，哪些“理所当然”的行为会突然失效。
