Python os.listdir docstring说“文件列表”，但目录也包括在内

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命令的帮助将“目录”列为文件属性。

这样的OS模块和文件系统详细信息不能说是通用的跨平台，但是在当今您最有可能处理的文件系统上，请记住，文件和目录是同一部分的一部分层次结构，并且文件系统API中的这两者之间会有一些等效。