本文介绍一种使用 pathlib 实现的健壮方案：无论输入是文件还是目录，均能返回包含完整路径及类型标识（'f' 或 'd'）的有序列表，并支持递归遍历与清晰区分。
本文介绍一种使用 pathlib 实现的健壮方案：无论输入是文件还是目录，均能返回包含完整路径及类型标识（'f' 或 'd'）的有序列表，并支持递归遍历与清晰区分。
在实际开发中，常需统一处理“任意路径目标”——它可能是单个文件，也可能是目录。传统方案（如 os.listdir、os.walk）往往假设输入必为目录，且难以兼顾文件/目录类型区分、绝对路径标准化和结果排序等需求。而 pathlib 提供了面向对象、语义清晰且跨平台友好的路径操作能力，是解决该问题的理想选择。
以下是一个完整、可直接复用的实现：
Python 3.14.2
下载
Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。
from pathlib import Path
from typing import List, Tuple
def scan_target(target: str | Path) -> List[Tuple[str, str]]:
"""
列出目标路径下的所有文件与子目录（含自身），并标注类型与排序。
参数:
target: 字符串路径或 Path 对象（支持 ~ 展开、相对路径解析）
返回:
List[Tuple[str, str]]: 元组列表，每个元组为 (type_flag, full_path)
- type_flag: 'f' 表示文件，'d' 表示目录
- full_path: 已解析的绝对路径字符串
规则:
- 若 target 是文件 → 返回仅含该文件的列表：[('f', '/abs/path/to/file')]
- 若 target 是目录 → 返回其自身 + 所有递归子项（文件+目录），去重后排序
"""
p = Path(target).expanduser().resolve()
if p.is_file():
return [('f', str(p))]
# 初始化结果：先加入根目录本身
result: List[Tuple[str, str]] = [('d', str(p))]
# 递归遍历所有后代项（rglob("*") 包含所有层级，但不包含根目录）
for item in p.rglob("*"):
if item.is_file():
result.append(('f', str(item)))
elif item.is_dir():
result.append(('d', str(item)))
# 按完整路径字符串升序排序（自然顺序，兼容中文/特殊字符）
return sorted(result, key=lambda x: x[1])
✅ 使用示例：
# 当前目录下所有内容（含自身）
for typ, path in scan_target("."):
print(f"{typ}: {path}")
# 指定文件（仅返回自身）
print(scan_target("/etc/hosts"))
# 输出：[('f', '/etc/hosts')]
# 指定子目录
print(scan_target("src"))
⚠️ 注意事项：
- rglob("*") 不包含起始目录本身，因此需显式添加 ('d', str(p))；
- Path.resolve() 自动处理符号链接、相对路径和 ~，确保返回真实绝对路径；
- sorted(..., key=lambda x: x[1]) 基于路径字符串排序，简洁可靠；若需按深度/名称自然排序，可改用 natsort 库；
- pathlib 在 Python 3.4+ 原生支持，无需额外依赖，且比 os 模块更易读、更安全（自动处理路径拼接与编码）；
- 对于超大目录，rglob 性能优于 os.walk（底层基于 scandir），但若仅需一层内容，请改用 iterdir()。
? 进阶建议：
如需支持过滤（如排除 .git）、限制深度或异步扫描，可在 rglob 后链式调用 filter() 或结合 pathlib.Path.match()；若追求极致性能且目标为纯目录结构分析，可考虑 os.scandir() 配合手动递归——但 pathlib 在绝大多数场景下已足够高效、清晰且可维护。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
