本文介绍使用 pathlib 替代 os.walk() 实现对目标路径下所有条目（包括文件、子目录、符号链接等）的准确类型识别与统一哈希统计，解决传统遍历中仅返回文件而忽略其他类型的问题。
本文介绍使用 pathlib 替代 os.walk() 实现对目标路径下所有条目（包括文件、子目录、符号链接等）的准确类型识别与统一哈希统计，解决传统遍历中仅返回文件而忽略其他类型的问题。
在原始代码中，开发者使用 os.walk() 遍历目录，但该函数的设计机制决定了它只在 fileList 中返回普通文件，而 dirList 仅提供子目录名称（不包含完整路径，也不参与后续类型判断），导致 os.path.isdir() 等检查始终无法在循环主体中被触发——因此所有条目都被错误归类为 "file"，目录、链接等类型完全丢失。
根本原因在于：os.walk() 的语义是「递归进入子目录」，其 fileList 仅包含当前层级的文件名列表，而 dirList 是当前层级的目录名列表（用于控制是否继续遍历）。它本身不将目录或链接作为“可处理条目”暴露给主循环，因此无法在单层循环中统一判断各类路径对象的类型。
更现代、更直观且类型安全的解决方案是采用 Python 标准库中的 pathlib 模块。Path(targetFolder).rglob("*") 可递归匹配路径下所有条目（含文件、目录、符号链接、设备文件等），每个 entry 都是 Path 对象，自带 .is_file()、.is_dir()、.is_symlink() 等语义清晰的判断方法，无需手动拼接路径或调用 os.path.*，大幅提升可读性与健壮性。
以下是优化后的完整实现：
from hashlib import sha256
from time import gmtime, strftime
from pathlib import Path
from prettytable import PrettyTable
FMT = "%Y-%m-%d %H:%M:%S"
targetFolder = input("Enter Target Folder: ")
print("Walking:", targetFolder, "\n")
tbl = PrettyTable(
["AbsPath", "Type", "FileSize", "UTC-Modified", "UTC-Accessed", "UTC-Created", "SHA-256 HASH"],
align="l"
)
for entry in Path(targetFolder).rglob("*"):
# 跳过自身（rglob("*") 包含起始路径，通常需过滤）
if entry == Path(targetFolder):
continue
if entry.is_file():
fileType = "file"
fileSize = entry.stat().st_size
hexDigest = sha256(entry.read_bytes()).hexdigest()
elif entry.is_dir():
fileType = "directory"
fileSize = 0 # 目录无逻辑大小，设为 0 或留空
hexDigest = ""
elif entry.is_symlink():
fileType = "symlink"
fileSize = 0
hexDigest = ""
else:
fileType = "unknown"
fileSize = 0
hexDigest = ""
try:
stats = entry.stat() # 注意：符号链接需用 lstat() 获取链接自身属性；此处用 stat() 会跟随链接
humanTimeLastModified = strftime(FMT, gmtime(stats.st_mtime))
humanTimeLastAccess = strftime(FMT, gmtime(stats.st_atime))
humanTimeLastCreated = strftime(FMT, gmtime(stats.st_ctime))
except OSError:
# 处理权限不足、断链等异常情况
humanTimeLastModified = humanTimeLastAccess = humanTimeLastCreated = "N/A"
tbl.add_row([
entry.as_posix(), # 使用 as_posix() 确保跨平台路径格式（/ 分隔）
fileType,
fileSize,
humanTimeLastModified,
humanTimeLastAccess,
humanTimeLastCreated,
hexDigest
])
print(tbl.get_string(sortby="FileSize", reversesort=True))关键改进说明：
- ✅ 类型全覆盖：通过 rglob("*") + is_*() 方法，真正支持文件、目录、符号链接、套接字、FIFO 等所有 POSIX 文件类型（is_socket(), is_fifo() 等可按需扩展）；
- ✅ 安全性提升：对 entry.stat() 加 try/except，避免因权限问题或损坏链接导致程序崩溃；
- ✅ 性能优化：仅对文件计算 SHA-256（跳过目录/链接），避免无效 I/O；
- ✅ 路径规范：使用 .as_posix() 输出统一风格路径，兼容 Windows/Linux/macOS；
- ⚠️ 注意符号链接行为：默认 stat() 会解析链接目标；若需获取链接本身的元数据（如创建时间），应改用 entry.lstat()。
此方案结构清晰、逻辑内聚，是 Python 3.4+ 环境下处理文件系统元数据的标准实践。
