Python os.path.listdir函数：获取指定路径下的所有文件名

一、介绍

os模块是Python标准库中常用的一个模块，它提供了很多与操作系统相关的功能，例如文件操作、进程管理、环境变量、文件系统位于树状结构中的路径操作等。os.path是os模块的一个子模块，它提供了与路径相关的操作。

os.path.listdir函数是os.path模块中的一个函数，可以用来获取指定路径下的所有文件名（路径名、子目录名、文件名），并以列表的形式返回。该函数不支持递归，只能获取指定路径下的文件，子目录的文件需要调用递归函数。

二、使用方法

os.path.listdir函数的使用方法如下：

import os

def get_filelist(path):
    """获取指定路径下的所有文件名"""
    file_list = []
    if os.path.exists(path):
        for file in os.listdir(path):
            file_path = os.path.join(path, file)
            if os.path.isfile(file_path):
                # 如果是文件则加入列表
                file_list.append(file)
    else:
        print('文件路径不存在')
    return file_list

if __name__ == '__main__':
    path = '/Users/xxx/Desktop'  # 指定路径
    file_list = get_filelist(path)
    print(file_list)

其中，os.path.join函数用于将目录名和文件名连接起来，组成完整的路径。os.path.isfile函数用于判断指定路径是否是文件，如果是，则将文件名加入列表中。

三、常见用途

os.path.listdir函数常用于遍历指定目录下的文件，并且可以用于后续对文件的处理。比如，可以根据后缀名来筛选需要的文件，或者根据文件修改时间进行排序等。

四、注意事项

调用os.path.listdir函数时需要注意以下几点：

1.路径格式：在常见的操作系统中，目录路径的分隔符有两种，Windows使用“\”作为分隔符，Linux和macOS使用“/”作为分隔符。因此，在编写脚本时需要根据操作系统选择相应的分隔符。

2.权限问题：如果当前用户没有权限访问指定路径中的文件，则函数将无法访问，需要将用户加入到对应的用户组或者修改文件的权限设置。

3.异常处理：在调用os.path.listdir函数时，可能会出现路径不存在、文件被删除等异常情况，需要进行相应的异常处理。

五、总结

os.path.listdir函数是Python中常用的一个函数，可以用于获取指定路径下的所有文件名，并以列表的形式返回。可以根据需求进行筛选、排序等操作。

在使用该函数时，需要注意路径格式、权限问题和异常处理等方面，确保脚本的正确执行。