Python笔记：dir() 和 help() 完整用法（适配Python二级 + IDLE实操）

一、dir () 函数：查询「有什么可用」

作用

查看对象身上所有的属性、方法 （变量.后面能调用的全部内容），只返回名字清单，不解释功能。

通俗理解：dir 是目录清单，告诉你这个东西有哪些工具。

语法

python 复制代码

dir(对象)

✅ 可以查询的对象（举例）

1. 查询变量（最常用）

python 复制代码

# 字符串
s = "hi python"
dir(s)

# 列表
lst = [1,2,3]
dir(lst)

# 字典
d = {"name":"test"}
dir(d)

# 数字
n = 10
dir(n)

2. 直接查询数据类型

不用创建变量，直接查看这个类型自带全部方法

python 复制代码

dir(str)    # 字符串类型全部方法
dir(list)   # 列表类型全部方法
dir(dict)   # 字典类型全部方法
dir(int)    # 整数类型

3. 查询导入的模块

python 复制代码

import random
dir(random) # 列出random模块里面所有函数

4. 查询自定义函数 / 类

python 复制代码

def test():
    pass
dir(test)

📌 dir 返回结果的两类名称（重点区分）

不带双下划线 ：日常写代码直接使用的方法 / 属性

例：split、append、keys、strip
前后双下划线 ****__xxx__ ：魔法方法，Python 底层自动调用，写代码基本不用手动调用，可以直接忽略。

实用过滤代码（只看可用方法，过滤魔法方法）

IDLE Shell 中逐行输入执行

python 复制代码

s = "hi python"
[name for name in dir(s) if not name.startswith("__")]

⚠️ 注意事项

IDLE >>>交互式窗口，一次只能输入一行代码，不能一次性粘贴多行，否则报语法错误。
dir不能查询关键字（if、for、while 等循环判断关键字），关键字要用help()查询。

二、help () 函数：查询「怎么用」

作用

查看对象、方法、模块、关键字的详细文档：功能说明、参数、示例。

通俗理解：help 是说明书，看懂工具怎么使用。

语法

python 复制代码

help(对象)
help(对象.方法名)

✅ 常用示例

1. 查询对象的某个具体方法（最常用！搭配 dir 使用）

python 复制代码

s = "hi python"
help(s.split)    # 查看字符串split分割方法的文档
help(s.replace)  # 查看替换方法
help(s.strip)    # 查看去除空格方法

lst = [1,2,3]
help(lst.append) # 列表追加元素方法

2. 查询内置函数

python 复制代码

help(print)
help(input)
help(range)

3. 查询整个类型的完整文档

python 复制代码

help(str)
help(list)

4. 查询模块

python 复制代码

import random
help(random.randint) # 查询随机整数函数

5. 查询关键字（if、for、while 等语法）

python 复制代码

help("for")
help("if")
help("while")

⚠️ 注意事项

help 执行后会输出大量文字，按回车滚动查看，按q退出文档页面。
括号内如果写方法名不要加 () ，help(s.split) ✔，不要写成help(s.split())。

三、dir + help 配套工作流程（IDLE 标准查代码步骤，二级备考重点）

场景：不知道字符串怎么分割文字

在 Shell 定义变量：>>> s = "apple,banana,orange"
>>> dir(s) → 列出全部方法，找到目标名字 split
>>> help(s.split) → 阅读文档，看懂参数用法
测试代码：>>> s.split(",") 运行看结果
确认无误，把代码复制到.py脚本文件

四、dir 和 help 对比表

函数	作用	返回内容	用途
`dir()`	查有哪些功能	名称列表	找方法名字
`help()`	查功能怎么用	详细文档、参数	看懂方法怎么调用

五、高频错题提醒

❌ 错误：help(s.split())

✅ 正确：help(s.split)

加括号代表执行函数，help 要传入方法本身，不是执行结果。
❌ Shell 一次性粘贴多行代码，触发multiple statements语法报错

✅ 正确：一行输入，回车，等待>>>提示符再输入下一行。
dir 不能直接看懂用法，只能看名字，必须配合 help。

六、背诵小口诀

dir 看目录，help 看说明；

dir 找名字，help 读详情；

双下划线，直接忽略掉。

随堂测试（你可以在 IDLE 直接试）

python 复制代码

# 1. 定义列表
lst = [5,3,9]
# 2. 查看列表所有可用方法
dir(lst)
# 3. 查看sort排序方法文档
help(lst.sort)
# 4. 测试执行
lst.sort()
print(lst)