os.listdir(dir_path)

`os.listdir(dir_path)` 是 Python 中的一个函数，用于返回指定目录下的所有文件和子目录的名称列表。它需要传递一个字符串参数 `dir_path`，表示要查询的目录路径。例如：

import os

files = os.listdir('/Users/username/Documents')
print(files)

这将返回目录 `/Users/username/Documents` 中所有文件和子目录的名称列表。输出结果类似于：

['file1.txt', 'file2.docx', 'subdir1', 'subdir2']

可以看到，返回的列表包含了该目录下所有的文件和子目录的名称。如果要获取完整路径，可以使用 `os.path.join()` 函数。例如：

import os

dir_path = '/Users/username/Documents'
files = os.listdir(dir_path)
full_paths = [os.path.join(dir_path, f) for f in files]
print(full_paths)

这将返回目录 `/Users/username/Documents` 中所有文件和子目录的完整路径列表。输出结果类似于：

['/Users/username/Documents/file1.txt', '/Users/username/Documents/file2.docx', '/Users/username/Documents/subdir1', '/Users/username/Documents/subdir2']

需要注意的是，`os.listdir()` 只会返回目录中的文件和子目录的名称，不会递归查询子目录下的文件和子目录。如果需要递归查询，可以使用 `os.walk()` 函数。