如何在 Python 中使用 os.listdir() 忽略隐藏文件？

---

在 Python 中处理文件夹或目录时，经常会遇到隐藏文件和文件夹。隐藏文件和文件夹是系统文件，不希望用户看到，可能包括配置文件、临时文件和与系统相关的数据。在许多情况下，您可能希望忽略这些隐藏文件，只处理可见文件，以避免混乱并提高代码效率。

在这篇深入的文章中，我们将探讨使用 Python 中的“os.listdir()”函数忽略隐藏文件的不同方法。我们还将提供分步说明和代码示例，引导您完成过滤隐藏文件并仅列出可见文件的过程。无论您是使用“os”模块还是利用“pathlib”模块，本文都将为您提供有效处理目录并忽略隐藏文件的知识。

让我们开始这段 Python 文件处理之旅，学习如何使用“os.listdir()”忽略隐藏文件！

使用列表推导式忽略隐藏文件

忽略隐藏文件并列出目录内容的最简单和最有效方法之一是使用列表推导式。列表推导式允许我们根据条件过滤掉特定项目，在本例中，我们可以使用它从“os.listdir()”返回的文件列表中排除隐藏文件。

示例

• 在下面的代码中，我们导入“os”模块，该模块提供与操作系统交互的函数，包括文件和目录操作。

• “list_visible_files_with_list_comprehension()”函数以“directory”作为输入，并通过使用列表推导式过滤隐藏文件来返回可见文件的列表。

• 我们使用“os.listdir(directory)”获取指定目录中项目（文件和目录）的列表。

• 然后，我们使用列表推导式迭代“os.listdir()”返回的项目，并且仅包含不以点开头（表示隐藏文件）的项目。

• 生成的“visible_files”列表仅包含可见文件的名称，我们返回此列表。

import os

def list_visible_files_with_list_comprehension(directory):
    visible_files = [file for file in os.listdir(directory) if not file.startswith('.')]
    return visible_files

使用 for 循环忽略隐藏文件

忽略隐藏文件并列出目录内容的另一种方法是使用 for 循环迭代文件，并将隐藏文件从最终列表中排除。

示例

• 在此示例中，我们定义了“list_visible_files_with_for_loop()”函数，该函数以“directory”作为输入，并通过迭代“os.listdir()”返回的项目并使用 for 循环排除隐藏文件来返回可见文件的列表。

• 我们创建一个名为“visible_files”的空列表来存储可见文件的名称。

• 使用 for 循环，我们迭代“os.listdir(directory)”返回的每个项目（文件或目录）。

• 在循环内，我们检查当前项目的名称是否不以点开头（表示隐藏文件）。如果不是，我们将项目的名称追加到“visible_files”列表中。

• 循环结束后，“visible_files”列表包含可见文件的名称，我们返回此列表。

import os

def list_visible_files_with_for_loop(directory):
    visible_files = []
    for file in os.listdir(directory):
        if not file.startswith('.'):
            visible_files.append(file)
    return visible_files

使用辅助函数确定隐藏文件

为了提高代码的可读性和可重用性，我们可以定义一个辅助函数来检查给定文件是否隐藏。然后，我们可以在列出目录内容时使用此函数过滤掉隐藏文件。

示例

• 在此示例中，我们定义了“is_hidden()”函数，该函数以“file”作为输入，如果文件以点开头（表示隐藏文件），则返回 True，否则返回 False。

• “list_visible_files_with_helper_function()”函数以“directory”作为输入，并通过使用列表推导式根据“is_hidden()”函数的结果过滤隐藏文件来返回可见文件的列表。

• 我们使用“os.listdir(directory)”获取指定目录中项目（文件和目录）的列表。

• 对于列表中的每个项目，我们调用“is_hidden()”函数来确定它是否为隐藏文件。如果不是隐藏文件，我们将它的名称包含在“visible_files”列表中。

• 迭代完所有项目后，“visible_files”列表包含可见文件的名称，我们返回此列表。

import os

def is_hidden(file):
    return file.startswith('.')

def list_visible_files_with_helper_function(directory):
    visible_files = [file for file in os.listdir(directory) if not is_hidden(file)]
    return visible_files

使用 pathlib.Path.iterdir() 忽略隐藏文件

“pathlib”模块提供了一种更现代化、面向对象的方式来处理文件路径。我们可以利用“Path.iterdir()”忽略隐藏文件，并仅列出目录中的可见文件。

示例

• 在此示例中，我们从“pathlib”模块导入“Path”类，该类表示文件系统路径。

• “list_visible_files_with_pathlib_iterdir()”函数以“directory”作为输入，并通过使用列表推导式和“path_object.iterdir()”过滤隐藏文件来返回可见文件的列表。

• 我们使用“Path(directory)”创建一个“Path”对象来表示输入目录。

• 我们使用列表推导式迭代“path_object.iterdir()”，并且仅包含不以点开头（表示隐藏文件）的项目的名称。

• 生成的“visible_files”列表包含可见文件的名称，我们返回此列表。

from pathlib import Path

def list_visible_files_with_pathlib_iterdir(directory):
    path_object = Path(directory)
    visible_files = [item.name for item in path_object.iterdir() if not item.name.startswith('.')]
    return visible_files

使用生成器列出可见文件

我们可以使用生成器一次生成一个可见文件，而不是返回可见文件的列表。生成器内存效率高，适用于包含大量文件的庞大目录。

示例

• 在此示例中，我们定义了“visible_files_generator()”函数，该函数以“directory”作为输入，并使用生成器一次生成一个可见文件名。

• 使用 for 循环，我们迭代“os.listdir(directory)”返回的项目。

• 在循环内，我们检查当前项目的名称是否不以点开头（表示隐藏文件）。如果不是，我们将项目的名称生成出来。

• “visible_files_generator()”函数不返回列表，而是返回一个生成器对象，可以使用 for 循环或在其他需要内存效率的环境中进行迭代。

import os

def visible_files_generator(directory):
    for file in os.listdir(directory):
        if not file.startswith('.'):
            yield file

在 Python 中处理文件夹或目录时，忽略隐藏文件是常见的需求，以便专注于相关数据并避免混乱。在这篇全面的文章中，我们探讨了使用“os.listdir()”函数和“pathlib”模块实现此目标的各种方法。

我们从简单的列表推导式和 for 循环开始，根据文件名过滤隐藏文件。然后，我们演示了如何通过创建辅助函数来确定文件是否隐藏来提高代码的可读性和可重用性。此外，我们还探讨了“pathlib”模块如何提供更现代、更优雅的目录处理方法。

最后，我们介绍了生成器的概念，它允许我们一次生成一个可见文件名，为大型目录提供内存高效的解决方案。

通过本指南获得的知识，您现在能够在使用 Python 处理目录时有效地忽略隐藏文件并专注于可见文件。无论您处理的是小型目录还是大型目录，这些技巧都将增强您的文件处理能力并简化您的 Python 项目。