Python 递归查找指定文件夹匹配扩展名路径

本文深入解析了如何用 Python 的 os.walk() 可靠地递归查找指定文件夹中所有匹配扩展名（如 .txt）的文件绝对路径，直击开发者常遇的“无文件返回”痛点——问题根源并非代码逻辑错误，而是路径依赖当前工作目录导致的定位失败；文章给出基于 __file__ 动态构建绝对路径的稳健方案，并强调扩展名格式、路径兼容性、调试技巧及权限处理等关键细节，助你一次写对、处处可用，彻底摆脱路径陷阱。

本文详解如何使用 os.walk() 正确遍历嵌套目录结构，精准获取指定扩展名（如 .txt）的所有文件绝对路径，并重点解决因工作目录不匹配导致的“无文件返回”常见问题。

本文详解如何使用 os.walk() 正确遍历嵌套目录结构，精准获取指定扩展名（如 .txt）的所有文件绝对路径，并重点解决因工作目录不匹配导致的“无文件返回”常见问题。

在实际项目中（例如处理 baby_names/yob1880.txt 等批量命名数据文件），我们常需自动化扫描整个目录树并收集特定类型文件的完整路径。你提供的 retrieve_files() 函数逻辑本身是正确的——它利用 os.walk() 深度遍历子目录，并用 str.endswith() 过滤扩展名。但函数失效的根本原因几乎总是路径错误，而非代码缺陷。

✅ 正确做法：使用绝对路径或基于脚本位置的动态路径

硬编码相对路径（如 "Assignment8" 或 "Desktop/python 2/FOLDER"）极易失败，因为 os.walk() 的起始路径是相对于当前工作目录（Current Working Directory, CWD），而非 Python 脚本所在位置。当你在终端/IDE 中从其他目录运行 main.py 时，os.walk("Assignment8") 会去 CWD 下找该文件夹，而非 main.py 同级目录。

推荐方案：使用 __file__ 动态定位根目录

import os

def retrieve_files(file_extension, root_folder="Assignment8"):
    """
    递归扫描指定根目录下所有子目录，返回匹配扩展名的完整文件路径列表。

    Args:
        file_extension (str): 目标扩展名，如 '.txt' 或 '.java'
        root_folder (str): 相对于当前脚本所在目录的根文件夹名

    Returns:
        list[str]: 包含绝对路径字符串的列表
    """
    # 获取当前 Python 脚本所在目录
    script_dir = os.path.dirname(os.path.abspath(__file__))
    # 构建目标根目录的绝对路径
    target_path = os.path.join(script_dir, root_folder)

    file_paths = []
    # 安全检查：确认路径存在且为目录
    if not os.path.isdir(target_path):
        raise ValueError(f"目标路径不存在或非目录: {target_path}")

    for root, dirs, files in os.walk(target_path):
        for file in files:
            if file.endswith(file_extension):
                full_path = os.path.join(root, file)
                file_paths.append(full_path)

    return file_paths

# 示例调用（在 main.py 中）
if __name__ == "__main__":
    try:
        txt_files = retrieve_files(".txt", root_folder="contents/baby_names")
        for path in txt_files:
            print(path)
        # 输出示例：
        # /path/to/FOLDER/contents/baby_names/yob1880.txt
        # /path/to/FOLDER/contents/baby_names/yob1881.txt
    except ValueError as e:
        print(f"错误: {e}")

⚠️ 关键注意事项

• 不要依赖当前工作目录（CWD）：永远避免 os.walk("Assignment8") 这类纯相对路径调用。
• 扩展名格式要统一：传入 ".txt" 而非 "txt" —— file.endswith() 匹配的是完整后缀。
• 路径分隔符兼容性：os.path.join() 自动处理 / 与 \，无需手动写 N:\\Code 或 "N:/Code"。
• 调试技巧：添加 print(f"Scanning: {target_path}") 和 print(f"Found {len(file_paths)} files") 快速验证路径是否正确。
• 权限与符号链接：os.walk() 默认跳过不可读目录；如需处理符号链接，可传入 followlinks=True 参数（谨慎使用，避免循环引用）。

✅ 总结

成功扫描文件的核心在于路径的可靠性。通过 os.path.abspath(__file__) 锚定脚本位置，再构建目标目录的绝对路径，即可彻底规避“找不到文件”的陷阱。此方法与操作系统、IDE 或终端启动位置完全解耦，是生产环境和教学项目的最佳实践。

今天关于《Python 递归查找指定文件夹匹配扩展名路径》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！