Python目录操作完全指南 os与pathlib实战用法

脚本专家

在 Python 开发中，目录操作既是基础也是高频场景。无论是要读取配置、遍历日志，还是管理项目文件，都绕不开获取当前目录、列出目录内容、递归遍历等操作。Python 标准库提供了 os 和 pathlib 两个核心模块，前者是传统函数式接口，后者是 Python 3.4+ 引入的面向对象路径库。对于新项目，pathlib 更直观、更 Pythonic，但 os 模块在处理系统级交互时依然不可替代。本文从实际开发角度出发，系统梳理这两个模块在目录获取与操作中的典型用法。

获取当前工作目录是很多文件操作的第一步。os.getcwd() 返回字符串，而 pathlib.Path.cwd() 返回 Path 对象，后者可以直接调用 .parent、.joinpath() 等方法。示例代码如下：

2. import os
3. current_dir = os.getcwd()
4. print(f"当前工作目录: {current_dir}")
6. from pathlib import Path
7. current_path = Path.cwd()
8. print(f"当前工作目录: {current_path}")
9. print(f"上级目录: {current_path.parent}")

复制代码

列出目录内容时，os.listdir(path) 仅返回文件名组成的字符串列表，不会包含路径信息。若要判断条目是文件还是目录，还需要配合 os.path.isdir() 或 os.path.isfile()。pathlib.Path.iterdir() 则返回 Path 对象生成器，每个条目自带完整路径，可以直接调用 .is_file()、.is_dir()、.name 等属性，更适合做进一步处理。

2. import os
3. path = "./data"
4. try:
5.     entries = os.listdir(path)
6.     for entry in entries:
7.         print(entry)
8. except FileNotFoundError:
9.     print(f"目录 '{path}' 不存在")
11. from pathlib import Path
12. path_obj = Path("./data")
13. if path_obj.exists() and path_obj.is_dir():
14.     for entry in path_obj.iterdir():
15.         print(f"{entry.name} - {'目录' if entry.is_dir() else '文件'}")

复制代码

递归遍历目录树时，os.walk() 是经典方案，它为每个目录返回 (dirpath, dirnames, filenames) 三元组。pathlib 则推荐使用 rglob() 和 glob()。rglob(pattern) 会递归匹配所有层级，glob(pattern) 仅匹配当前目录。例如递归查找所有 .py 文件：

2. import os
3. for dirpath, dirnames, filenames in os.walk("./project"):
4.     print(f"目录: {dirpath}")
5.     print(f"子目录: {dirnames}")
6.     print(f"文件: {filenames}")
7.     print("-" * 40)
9. from pathlib import Path
10. project = Path("./project")
11. py_files = list(project.rglob("*.py"))
12. for f in py_files:
13.     print(f)

复制代码

获取绝对路径也很关键。相对路径容易受脚本启动位置影响，使用绝对路径更可靠。os.path.abspath() 可以把相对路径转为绝对路径；pathlib 的 resolve() 不仅返回绝对路径，还会解析符号链接。

2. import os
3. abs_path = os.path.abspath("./docs/readme.txt")
4. print(abs_path)
6. from pathlib import Path
7. abs_path2 = Path("./docs/readme.txt").resolve()
8. print(abs_path2)

复制代码

在操作前检查路径是否是目录，可以提前避免很多错误。os.path.isdir() 接收字符串，Path.is_dir() 是实例方法，两者注意区分。

创建目录时，os.makedirs() 和 Path.mkdir() 都支持递归创建多级目录。os.makedirs() 需要设置 exist_ok=True 才能避免目录已存在时抛异常；Path.mkdir() 需要设置 parents=True 才能递归创建父目录，同时配合 exist_ok=True 避免冲突。删除目录方面，os.rmdir() 只能删除空目录，非空目录必须用 shutil.rmtree()，该操作不可逆，要特别谨慎。

2. import os
3. from pathlib import Path
4. import shutil
6. os.makedirs("./parent/child/grandchild", exist_ok=True)
7. Path("./deep/nested/path").mkdir(parents=True, exist_ok=True)
9. os.rmdir("./empty_dir")  # 仅空目录
10. shutil.rmtree("./dir_with_content")  # 递归删除，危险！

复制代码

路径拼接与分解在跨平台开发中尤为重要。直接使用字符串拼接“/”在 Windows 上可能出错。os.path.join() 能根据操作系统自动选择分隔符，pathlib 则直接用“/”运算符重载，更为优雅。

2. import os
3. full_path = os.path.join("/home/user", "docs", "file.txt")
4. print(full_path)
6. from pathlib import Path
7. base = Path("/home/user")
8. full_path2 = base / "docs" / "file.txt"
9. print(full_path2)
10. print(f"父目录: {full_path2.parent}")
11. print(f"文件名: {full_path2.name}")
12. print(f"后缀: {full_path2.suffix}")
13. print(f"无后缀文件名: {full_path2.stem}")

复制代码

实战中，统计目录下文件类型分布是常见需求。通过 rglob("*") 遍历全部条目，筛选出文件，再按后缀名分组计数，很容易实现：

2. from pathlib import Path
3. from collections import Counter
5. def analyze_directory(directory_path):
6.     path = Path(directory_path)
7.     if not path.exists() or not path.is_dir():
8.         print(f"错误: '{directory_path}' 不是有效目录")
9.         return
11.     extensions = []
12.     for item in path.rglob("*"):
13.         if item.is_file():
14.             ext = item.suffix.lower() or "无后缀"
15.             extensions.append(ext)
17.     if not extensions:
18.         print("该目录下未找到文件。")
19.         return
21.     counter = Counter(extensions)
22.     print(f"目录 '{directory_path}' 下的文件类型统计:")
23.     for ext, count in counter.most_common():
24.         print(f"  {ext}: {count} 个文件")
26. analyze_directory("./my_project")

复制代码

总结几点最佳实践：优先使用 pathlib，尤其在新项目中，它封装了路径对象，方法链式调用更清晰；文件系统操作必须处理异常，如权限不足、路径不存在，用 try/except 包裹关键步骤；脚本中涉及关键路径时尽量使用绝对路径或 resolve()，避免工作目录变化导致找不到文件；递归操作如 rglob() 和 shutil.rmtree() 要反复确认目标路径，防止误删；跨平台项目统一使用 os.path.join() 或 pathlib 的“/”操作符，让代码在 Windows 和 Linux/macOS 上都能正确处理路径分隔符。

掌握这些目录操作细节后，后续编写文件处理脚本、日志分析工具或自动化构建流程都会更加得心应手。

热心网友3

这篇文章很实用，正好最近在折腾文件批量处理，os 和 pathlib 的对比讲得很清楚。以前习惯用 os，现在感觉 pathlib 的链式操作确实更顺手，特别是 `Path.cwd()` 和 `/` 拼接路径那部分，代码看起来干净多了。递归遍历用 `rglob` 也比手动 `os.walk` 省事，感谢分享！

热心网友3

这篇指南写得很清楚，正好最近在整理项目文件结构，os 和 pathlib 的对比部分特别实用。pathlib 的 `/` 运算符拼接路径确实比 `os.path.join` 优雅不少，不过 Windows 上 `resolve()` 解析符号链接的行为有时候会和预期不太一样，不知道楼主有没有遇到过？另外 `rglob` 在目录特别大时性能怎么样，有没有什么优化建议？

热心网友3

干货满满，正好最近在从 os 迁移到 pathlib，这篇把两者的差异和适用场景讲得很清楚。尤其是 rglob 递归查找和 Path.resolve() 解析符号链接这部分，实际项目里太常用了。另外提醒一下新手朋友，shutil.rmtree 真的慎用，删之前最好先打印确认路径，别问我是怎么知道的……收藏了，以后当速查手册用。