一、dir函数的概述
Python的dir()函数用于查看对象的内置方法。它返回一个包含字符串的列表，这些字符串是对象所拥有的方法、属性和变量的名称。
dir()函数适用于任何对象，包括模块、类、函数、字符串等。当应用dir()函数时，它会先打印出一些特殊的方法，然后按字母顺序列出所有名称。
# 使用dir()函数查看list对象所有方法、属性和变量名称
>>> dir(list)
['__add__', '__class__',..., 'sort', 'sorted', 'sort_reverse', 'startswith']
二、dir函数的使用方法
通过充分利用dir()函数，可以快速地查看对象中的方法和属性。
需要注意的是，dir()函数返回的列表中包含了对象的所有属性，包括一些具有下划线前缀的属性，它们不应该被视为公共API的一部分，因此不应该被在文档中引用。如果仅仅关注对象的公共API，可以使用help()函数或文档查看模块。
# 使用dir()函数和help()函数了解list对象的append方法
>>> dir(list)
['__add__', '__class__',..., 'sort', 'sorted', 'sort_reverse', 'startswith']
>>> help(list.append)
Help on method_descriptor in list:
list.append = append(...)
L.append(object) -> None -- append object to end
三、dir函数的返回值说明
dir()函数返回的是对象的属性名列表。这些属性名可以是字符串，也可以是可以执行的属性（如方法或变量）。有时，用户只想了解对象的一部分属性名，可以向dir()函数传递一个可选参数，如模块名称或对象名称。
当dir()函数应用于模块时，将返回模块中定义的所有名称。
# 使用dir()函数查看os模块中的属性名
>>> import os
>>> dir(os)
['DirEntry', 'F_OK', 'MutableMapping',..., 'utime', 'waitpid']
当dir()函数应用于类时，将返回类或类的实例定义的所有名称。
# 创建一个包含append方法的list对象，并查看其所有属性名
>>> a = [1,2,3]
>>> dir(a)
['__add__', '__class__',..., 'sort', 'sorted', 'sort_reverse', 'startswith']
四、dir函数的用途
dir()函数在软件测试和调试中非常有用。它可以快速地查看模块、类或对象中的所有属性，帮助程序员了解对象和其所有方法，从而更好地使用它们。
dir()函数也可以用于查找属性的特定信息，如函数参数和docstring。
# 在查看模块os中的listdir函数的docstring
>>> import os
>>> help(os.listdir)
Help on built-in function listdir in module nt:
listdir(path=None) method of nt._local._LocalPathWrapper instance
Return a list containing the names of the entries in the directory.
path: path of directory to list; defaults to the current directory.
五、dir函数的注意事项
dir()函数返回的列表包括对象的所有属性，包括通过Python解释器内部机制注入的属性。用户应该谨慎使用属性名列表。
最后，如果用户需要探索Python程序的内部结构，可以使用内置的inspect模块，它提供了许多与dir()函数类似的函数。
# 使用inspect模块中的getmembers函数查看os模块中所有方法和属性的信息
>>> import os
>>> import inspect
>>> members = inspect.getmembers(os)
>>> for member in members:
... print(member)
...
('DirEntry', <class 'os.DirEntry'>)
('F_OK', 0)
('MutableMapping', <class 'collections.abc.MutableMapping'>)
...
('waitpid', <function waitpid at 0x00000256A12920D0>)
