Python os.listdir 文档字符串显示 "list of files"但也包含目录

Question

在Python 3.6.4中，根据os.listdir方法的文档字符串:

import os
help(os.listdir)
Help on built-in function listdir in module nt:

listdir(path=None)
    Return a list containing the names of the files in the directory.
...

帮助中说它返回目录中的文件列表，但实际上它不仅返回文件，还返回文件夹。

文档字符串是否需要更正？

Answer 1

虽然如果有所更改可能会很好，但此信息不一定是错误的。它可能源于 Unix 习语“一切都是文件”，并且在类 Unix 操作系统上，即使用户不同意这些语义，目录也是文件。 Windows 也这样做。 dir 命令的帮助将“目录”列为文件属性。

像这样的操作系统模块和文件系统详细信息不能说是普遍跨平台的，但是在您今天最有可能处理的文件系统上，值得记住的是文件和目录是相同的一部分层次结构，并且两者在文件系统 API 中会有一些等效性。