### Python 中 `help()` 和 `dir()` 函数的用法及区别 #### 1. 定义与功能 - **`dir()` 函数** `dir()` 是一个内置函数，用于返回指定对象的所有属性和方法名称组成的列表。如果没有参数传递给 `dir()`，它将列出当前作用域中的所有变量、模块和其他定义的名字[^2]。此函数非常适合用来探索某个类型的可用属性或方法。 - **`help()` 函数** `help()` 提供关于任何内建对象的帮助信息，包括完整的描述文档字符串（Docstring）。它可以显示类、函数、模块或其他对象的相关帮助信息[^1]。这使得开发者能够在交互环境中轻松获取详细的解释说明。 #### 2. 使用示例 ##### (1) `dir()` 示例 下面展示了如何利用 `dir()` 查看字符串类型 (`str`) 所拥有的全部成员： ```python >>> import string >>> dir(string) ['__all__', '__builtins__', '__cached__', '__doc__', '__file__', '__loader__', '__name__', '__package__', '__spec__', '_ChainMap', '_TemplateMetaclass', 'Formatter', 'Template', 'ascii_letters', 'ascii_lowercase', 'ascii_uppercase', 'capwords', 'digits', 'hexdigits', 'octdigits', 'printable', 'punctuation', 'whitespace'] ``` 这里列出了标准库中 `string` 模块下的各个组成部分[^4]。 ##### (2) `help()` 示例 接着来看一下怎样运用 `help()` 获取特定主题的具体指导资料： ```python >>> help(str.split) Help on method_descriptor: split(self, /, sep=None, maxsplit=-1) Return a list of the words in the string, using sep as the delimiter string. sep The delimiter according which to split the string. None (the default value) means split according to any whitespace, and discard empty strings from the result. maxsplit Maximum number of splits to do. -1 (the default value) means no limit. ``` 上面的例子清楚地阐述了 `str.split()` 方法的作用及其参数含义[^1]。 #### 3. 主要差异比较 | 方面 | `dir()` | `help()` | |--------------|---------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------| | 输出形式 | 返回的是由字符串构成的列表 | 显示详尽的文字叙述 | | 查询范围 | 展现目标实体内部所有的公有私有字段名 | 集中展示公开接口部分 | | 应用场合 | 当希望快速浏览某物包含哪些组件时适用 | 如果想知道某一特性确切的工作原理或是语法格式的时候更为合适 | 总结来说，当你仅仅关心一个对象拥有哪些成员而不关注细节实现的话可以选择使用 `dir()`；而如果你需要深入理解一段代码的功能或者正确调用方式，则应优先考虑求助于 `help()`[^3]。 --- ###