Python获取文件夹所有文件名方法

在文章实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《Python获取文件夹下所有文件名方法》，聊聊，希望可以帮助到正在努力赚钱的你。

最直接的方法是使用os.listdir()获取指定路径下的文件和子目录名，若需递归遍历则使用os.walk()，结合os.path.join()和os.path.isdir()/isfile()可区分文件与目录，处理权限、隐藏文件等特殊情况时需添加异常捕获和过滤逻辑。

Python中要获取一个文件夹下的所有文件名，最直接的方法通常是使用os模块里的os.listdir()函数，它能列出指定路径下的所有文件和子目录名。如果需要更深层次的遍历，比如包含子文件夹中的文件，那么os.walk()会是你的不二之选，它提供了一个递归遍历目录树的强大机制。

解决方案

说实话，每次遇到这种需求，我脑子里首先跳出来的就是os模块。它就像是Python和操作系统文件系统之间的一座桥梁，非常实用。

使用 os.listdir() 获取当前目录下的文件和文件夹名

如果你只需要获取某个特定文件夹（不包括其子文件夹）里的内容，os.listdir()是最简单直接的方式。它返回的是一个列表，里面包含了该路径下所有文件和子目录的名字。

import os

def list_files_in_directory(path):
    """
    获取指定路径下的所有文件和子目录名（非递归）。
    """
    if not os.path.exists(path):
        print(f"路径 '{path}' 不存在。")
        return []

    try:
        items = os.listdir(path)
        print(f"'{path}' 下的内容：")
        for item in items:
            print(item)
        return items
    except PermissionError:
        print(f"没有权限访问路径 '{path}'。")
        return []
    except Exception as e:
        print(f"发生错误：{e}")
        return []

# 示例用法
# 假设我们有一个名为 'my_folder' 的文件夹，里面有一些文件和子文件夹
# my_folder/
# ├── file1.txt
# ├── sub_folder_a/
# │   └── file_a1.py
# └── file2.log

# 先创建一个测试目录和文件，方便演示
test_dir = 'temp_test_dir'
if not os.path.exists(test_dir):
    os.makedirs(test_dir)
    with open(os.path.join(test_dir, 'report.txt'), 'w') as f:
        f.write('hello')
    with open(os.path.join(test_dir, 'data.csv'), 'w') as f:
        f.write('1,2,3')
    os.makedirs(os.path.join(test_dir, 'nested_dir'))
    with open(os.path.join(test_dir, 'nested_dir', 'config.json'), 'w') as f:
        f.write('{}')

print("--- 使用 os.listdir() ---")
list_files_in_directory(test_dir)

# 清理测试目录
# import shutil
# if os.path.exists(test_dir):
#     shutil.rmtree(test_dir)

这里需要注意的是，os.listdir()返回的只是文件名或目录名，不包含它们的完整路径。如果你想对这些文件做进一步操作，比如读取内容，你就得自己用os.path.join()把路径拼接起来。

使用 os.walk() 进行递归遍历

当你的需求是遍历整个目录树，包括所有子目录下的文件时，os.walk()就显得无比强大了。它会生成器，每次迭代都会返回一个三元组(root, dirs, files)。

• root：当前正在遍历的目录的路径。
• dirs：root下所有子目录的列表。
• files：root下所有文件的列表。

这个设计非常巧妙，它让你能在一个循环里同时处理当前目录、子目录列表和文件列表。

import os

def walk_through_directory(path):
    """
    递归遍历指定路径下的所有文件和目录。
    """
    if not os.path.exists(path):
        print(f"路径 '{path}' 不存在。")
        return

    print(f"\n--- 使用 os.walk() 遍历 '{path}' ---")
    try:
        for root, dirs, files in os.walk(path):
            print(f"\n当前目录: {root}")
            print(f"子目录: {dirs}")
            print(f"文件: {files}")

            # 我们可以这样获取所有文件的完整路径
            for file in files:
                full_file_path = os.path.join(root, file)
                print(f"找到文件: {full_file_path}")
    except PermissionError:
        print(f"没有权限访问路径 '{path}' 或其子目录。")
    except Exception as e:
        print(f"发生错误：{e}")

# 示例用法
walk_through_directory(test_dir)

os.walk()的强大之处在于，它帮你处理了递归的逻辑，你只需要关注每个层级下的内容即可。

目录遍历时如何区分文件与子目录？——os.path.join与os.path.isdir的妙用

这是个非常常见的问题，os.listdir()虽然能列出所有条目，但它不会告诉你哪些是文件，哪些是目录。单纯看名字，你可分不出来。这时候，os.path模块就派上用场了，特别是os.path.join()、os.path.isdir()和os.path.isfile()这几个函数。

首先，os.listdir()返回的只是一个相对名字，比如file1.txt或sub_folder_a。要判断它们的类型，你必须先得到它们的完整路径。os.path.join()就是用来干这个的，它能智能地拼接路径，自动处理不同操作系统下的路径分隔符（比如Windows的\和Linux的/）。

import os

def distinguish_files_and_dirs(path):
    """
    遍历指定路径，并区分文件和子目录。
    """
    if not os.path.exists(path):
        print(f"路径 '{path}' 不存在。")
        return

    print(f"\n--- 区分 '{path}' 下的文件和目录 ---")
    try:
        items = os.listdir(path)
        for item in items:
            full_path = os.path.join(path, item) # 拼接成完整路径
            if os.path.isdir(full_path):
                print(f"[目录]: {full_path}")
            elif os.path.isfile(full_path):
                print(f"[文件]: {full_path}")
            else:
                print(f"[其他]: {full_path}") # 比如软链接、管道等
    except PermissionError:
        print(f"没有权限访问路径 '{path}'。")
    except Exception as e:
        print(f"发生错误：{e}")

# 示例用法
distinguish_files_and_dirs(test_dir)

os.path.isdir(full_path)会检查full_path是否指向一个目录，而os.path.isfile(full_path)则检查它是否指向一个普通文件。这样一来，即使os.listdir()只给了你名字，你也能通过这些辅助函数，准确地识别出它们的“身份”。这个组合拳，在处理文件系统操作时，简直是家常便饭。

递归遍历目录：os.walk()的深度解析与实践

前面简单提到了os.walk()，但它的强大远不止于此。我个人觉得，如果你需要处理的目录结构比较复杂，或者你压根不知道目录有多深，os.walk()几乎是唯一的、最优雅的选择。它不像你手动写递归函数那样容易出错，而且性能也相当不错。

os.walk()的核心思想是“自顶向下”（top-down）遍历，默认情况下是这样。它会先访问父目录，然后是其子目录，再到子目录的子目录，以此类推。每次迭代返回的(root, dirs, files)三元组，给了你极大的控制权。

• root: 当前正在访问的目录的完整路径。
• dirs: root目录下的所有子目录的名称列表。这个列表是可修改的！这是os.walk()最酷的地方之一。如果你修改了这个列表（比如删除某个子目录名），os.walk()就不会再进入那个子目录进行遍历。这对于“剪枝”操作非常有用，比如你只想遍历某些特定类型的目录，或者跳过一些你知道不需要处理的目录。
• files: root目录下的所有文件的名称列表。

让我们看一个更实际的例子：如何找到一个目录下所有扩展名为.txt的文件，并且跳过任何名为temp的子目录。

import os

def find_txt_files_and_prune(start_path):
    """
    递归查找所有 .txt 文件，并跳过名为 'temp' 的子目录。
    """
    if not os.path.exists(start_path):
        print(f"起始路径 '{start_path}' 不存在。")
        return []

    found_txt_files = []
    print(f"\n--- 深度解析 os.walk()：查找 .txt 文件并剪枝 ---")
    try:
        for root, dirs, files in os.walk(start_path):
            # 这是一个关键点：修改 dirs 列表来剪枝
            # 创建一个临时列表来存储需要继续遍历的目录
            dirs_to_keep = [d for d in dirs if d != 'temp'] 
            # 清空原始 dirs 列表，然后用我们筛选过的列表填充
            dirs[:] = dirs_to_keep # 注意这里是原地修改，非常重要！

            print(f"\n当前遍历到: {root}")
            print(f"将要遍历的子目录: {dirs}") # 打印修改后的 dirs

            for file in files:
                if file.endswith('.txt'):
                    full_path = os.path.join(root, file)
                    found_txt_files.append(full_path)
                    print(f"发现 .txt 文件: {full_path}")
        return found_txt_files
    except PermissionError:
        print(f"没有权限访问路径 '{start_path}' 或其子目录。")
        return []
    except Exception as e:
        print(f"发生错误：{e}")
        return []

# 额外创建一些测试文件和目录来演示剪枝
temp_dir_to_skip = os.path.join(test_dir, 'temp')
if not os.path.exists(temp_dir_to_skip):
    os.makedirs(temp_dir_to_skip)
    with open(os.path.join(temp_dir_to_skip, 'ignore_me.txt'), 'w') as f:
        f.write('This should not be found.')
with open(os.path.join(test_dir, 'another.txt'), 'w') as f:
    f.write('Another text file.')

# 示例用法
find_txt_files_and_prune(test_dir)

# 清理测试目录
import shutil
if os.path.exists(test_dir):
    shutil.rmtree(test_dir)

通过修改dirs列表，我们有效地控制了os.walk()的遍历路径，这比在循环内部做复杂的条件判断要高效和直观得多。此外，os.walk()还有一个topdown参数，设置为False时，它会先遍历子目录中的内容，再回到父目录，这在某些需要先处理叶子节点（比如删除文件）的场景下很有用。

处理特殊情况与常见陷阱：权限问题、隐藏文件与编码

文件系统操作从来都不是一帆风顺的，总会遇到一些“小麻烦”。作为一名真实的作者，我深知这些坑，所以在这里分享一些经验，希望能帮你少踩雷。

1. 权限问题（PermissionError）

这是最常见的错误之一。当你尝试访问一个没有读取权限的目录或文件时，Python会抛出PermissionError。比如，在Linux或macOS上，有些系统目录（如/proc、/sys）就不能随便访问。

解决方案： 最直接有效的方法就是使用try-except块来捕获这个错误。当你遍历目录时，如果遇到权限问题，可以简单地跳过那个目录，或者记录下来以便后续处理。

import os

def handle_permission_error(path):
    print(f"\n--- 处理权限错误示例 ---")
    try:
        # 尝试访问一个可能没有权限的目录，这里用一个不存在的路径模拟
        # 在实际环境中，你可能需要尝试访问如 '/root' (Linux) 或其他受限目录
        # 这里为了演示，我们假设 test_dir 中的某个子目录会触发权限错误
        # 实际上，os.walk 会在遇到无法访问的目录时抛出错误

        for root, dirs, files in os.walk(path):
            print(f"正在访问: {root}")
            # 模拟一个子目录没有权限，把它从 dirs 中移除，这样 os.walk 就不会尝试进入
            # 实际场景中，错误会在 os.walk 尝试进入该目录时抛出
            if 'restricted_dir' in dirs:
                print(f"发现受限目录 'restricted_dir'，跳过。")
                dirs.remove('restricted_dir') # 这样 os.walk 就不会进入这个目录了

            for file in files:
                full_path = os.path.join(root, file)
                # 尝试对文件进行操作，这里可能会触发权限错误
                # 比如 os.remove(full_path)
                pass

    except PermissionError as e:
        print(f"捕获到权限错误: {e}")
        print(f"无法访问路径 '{e.filename}'，请检查权限。")
    except Exception as e:
        print(f"发生其他错误: {e}")

# handle_permission_error('/root') # 实际测试时，请用你系统上一个你知道没权限的目录
# 这里我们用一个普通目录来演示 try-except 结构
# 为了演示，我们不真的去制造权限错误，而是展示如何捕获

2. 隐藏文件和目录

不同操作系统对隐藏文件有不同的约定。在Linux和macOS上，以.开头的目录或文件通常是隐藏的（比如.bashrc, .git）。在Windows上，文件或目录可能被设置了“隐藏”属性。

解决方案： os.listdir()和os.walk()默认都会列出这些隐藏文件。如果你想过滤掉它们，就需要自己写逻辑。

import os

def filter_hidden_items(path):
    """
    过滤掉以 '.' 开头的隐藏文件和目录。
    """
    print(f"\n--- 过滤隐藏文件和目录 ---")
    try:
        for root, dirs, files in os.walk(path):
            # 过滤隐藏目录
            dirs[:] = [d for d in dirs if not d.startswith('.')]

            print(f"\n当前目录 (非隐藏): {root}")
            print(f"子目录 (非隐藏): {dirs}")

            # 过滤隐藏文件
            non_hidden_files = [f for f in files if not f.startswith('.')]
            for file in non_hidden_files:
                full_path = os.path.join(root, file)
                print(f"发现非隐藏文件: {full_path}")
    except Exception as e:
        print(f"发生错误：{e}")

# 创建一个隐藏文件和目录来测试
test_dir_hidden = 'temp_test_dir_with_hidden'
if not os.path.exists(test_dir_hidden):
    os.makedirs(test_dir_hidden)
    with open(os.path.join(test_dir_hidden, 'visible.txt'), 'w') as f:
        f.write('visible')
    with open(os.path.join(test_dir_hidden, '.hidden_file.txt'), 'w') as f:
        f.write('hidden')
    os.makedirs(os.path.join(test_dir_hidden, '.hidden_dir'))
    with open(os.path.join(test_dir_hidden, '.hidden_dir', 'inside_hidden.txt'), 'w') as f:
        f.write('inside hidden')

filter_hidden_items(test_dir_hidden)

# 清理
import shutil
if os.path.exists(test_dir_hidden):
    shutil.rmtree(test_dir_hidden)

对于Windows的隐藏属性，你需要使用os.stat()获取文件状态，然后检查st_file_attributes字段，但这会更复杂一些，通常在跨平台应用中，我们主要关注'.'开头的约定。

3. 编码问题

在Python 3中，文件系统路径通常以Unicode字符串表示，os模块在处理文件名时会尽量使用系统的默认编码。但在某些极端情况下，比如文件系统上存在非标准编码的文件名，或者你在不同的操作系统之间移动文件，可能会遇到编码错误（UnicodeDecodeError）。

解决方案： 大多数情况下，Python 3的os模块能很好地处理各种编码的文件名。如果真的遇到问题，你可能需要确保你的系统语言环境（locale）设置正确。对于一些极端情况，可以尝试使用os.fsdecode()和os.fsencode()来显式地进行编码和解码，但这通常是不必要的，而且会增加代码的复杂性。一般来说，保持系统编码一致性是最好的预防措施。

总的来说，处理文件系统操作时，多一份警惕，多用try-except，能帮你省去不少麻烦。这些“坑”都是真实世界中会遇到的，理解它们，才能写出健壮的代码。

今天关于《Python获取文件夹所有文件名方法》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！