参考手册

最后更新：2026-09-22

参考手册

按字母序排列的 269 个 Python 条目及其语法、参数、版本兼容性与示例。

#
运算符	运算符专项页：算术、比较、赋值、逻辑、位、成员与身份运算符，含优先级表。
__import__()	__import__ 是 import 语句底层调用的函数；日常请用 import 语句。仅在动态导入场景使用。
A
abs()	abs() 返回一个数的绝对值。对整数和浮点数都适用；复数返回模。
all()	all() 接收一个可迭代对象，仅当所有元素都为真（或可迭代对象为空）时返回 True。
any()	any() 接收一个可迭代对象，若至少有一个元素为真则返回 True；空对象返回 False。
ascii()	ascii() 与 repr() 类似，但会把非 ASCII 字符转义为 \x、\u 或 \U 转义序列。
anext()	anext(awaitable) 返回 awaitable 的下一项；耗尽时抛 StopAsyncIteration。
aiter()	aiter(async_iterable) 返回异步可迭代对象的异步迭代器。
anext()	anext(async_iterator[, default]) 返回异步迭代器的下一个元素。
as	as 给导入的模块/名称起别名；也用于 with 语句给异常/上下文起别名。
assert	assert expression[, msg] 在 expression 为假时抛 AssertionError；用 -O 运行可被禁用。
async	async 用于声明 async def 函数或 async with 上下文。
await	await 在 async 函数内等待 awaitable（coroutine / Task / Future）。
B
bin()	bin() 把整数转成以 '0b' 开头的二进制字符串。
bool()	bool() 把一个值转成布尔类型：除了 0、0.0、空字符串、空容器、None 等「假值」外都返回 True。
breakpoint()	breakpoint() 进入调试器（默认 pdb）；可通过 PYTHONBREAKPOINT 环境变量或 sys.breakpointhook() 替换。
bytearray()	bytearray() 返回可变字节数组，元素是 0-255 的整数。
bytes()	bytes() 返回不可变字节序列；可由字节序列、字符串 + 编码或可迭代整数构造。
break	break 立即终止当前 for / while 循环。
C
callable()	callable() 判断对象是否可调用（函数、类、带 __call__ 的对象等）。
chr()	chr() 把 Unicode 码点（0-0x10FFFF）转成单字符字符串。
classmethod()	@classmethod 把一个方法标记为类方法，第一个参数是 cls（类本身）。
compile()	compile() 把源代码字符串编译成代码对象，可交给 exec() / eval() 执行。
complex()	complex() 用 real + imag*j 构造复数；不传参数返回 0j。
copyright()	copyright() 打印 Python 解释器的版权信息（交互式解释器）。
credits()	credits() 打印贡献者致谢信息。
continue	continue 立即结束本轮循环，进入下一轮。
class	class 定义一个新类型；支持单继承与多继承。
case	case pattern 是 match 语句的分支；可使用 \| 或 _ 通配。
contextmanager-async	async with 在异步上下文管理器中使用：进入/退出都 await 异步方法。
D
delattr()	delattr(obj, name) 删除 obj 上的属性 name；等价于 del obj.name。
dict()	dict() 创建字典；可由关键字参数、可迭代键值对或其他映射构造。
dir()	dir() 不传参数返回当前作用域的变量名；传对象返回该对象的所有属性与方法名列表。
divmod()	divmod(a, b) 返回 (a // b, a % b)；对浮点也适用。
dict.clear()	dict.clear() 删除字典所有键值对。
dict.copy()	dict.copy() 返回字典的浅拷贝。
dict.fromkeys()	dict.fromkeys(iterable[, value]) 用 iterable 的元素作为键、value（默认 None）作为值构造新字典。
dict.get()	dict.get(key[, default]) 返回键对应的值；键不存在返回 default（默认 None），不抛 KeyError。
dict.items()	dict.items() 返回 (key, value) 视图对象，可迭代。
dict.keys()	dict.keys() 返回键视图对象，支持集合操作（& \| - ^）。
dict.pop()	dict.pop(key[, default]) 删除 key 并返回其值；key 不存在时返回 default，否则 KeyError。
dict.popitem()	dict.popitem() 删除并返回一对 (key, value)（LIFO 顺序）；空字典抛 KeyError。
dict.setdefault()	dict.setdefault(key[, default]) 若 key 存在返回值，否则插入 key:default 并返回 default。
dict.update()	dict.update([other]) 用 other 的键值对更新字典；other 可为 dict、键值对可迭代对象或关键字参数。
dict.values()	dict.values() 返回值视图对象。
def	def 定义一个函数；可带参数列表和 return 表达式。
del	del 删除变量名、属性或容器中的元素（释放引用）。
E
enumerate()	enumerate(iterable, start=0) 在迭代时同时给出索引与元素，常用于 for 循环中。
eval()	eval() 执行字符串中的 Python 表达式，返回结果。安全警告：不要用 eval 处理不可信输入。
exec()	exec() 执行字符串中的 Python 代码（语句或代码块），不返回值。
exit()	exit()（或 quit()）退出交互式 Python 解释器，抛出 SystemExit。不应在生产代码中使用。
elif	elif 是「else if」的缩写，必须紧跟 if 之后，用于多分支判断。
else	else 在 if / elif / for / while / try 等语句后，表示「前面分支都没命中」或「循环正常结束」。
except	except 紧跟 try，处理匹配的异常类型（可指定元组）；as 可绑定异常对象。
Ellipsis	... 是 Ellipsis 的字面量，常用于类型注解或占位（NumPy 等库广泛使用）。
F
filter()	filter(function, iterable) 保留 iterable 中使 function 返回 True 的元素；返回迭代器。
float()	float() 把字符串或数字转成浮点数；不传参数返回 0.0。
format()	format(value, format_spec='') 返回 value 按格式说明符格式化后的字符串。
frozenset()	frozenset() 返回不可变集合；元素必须是可哈希的，可哈希自身（可作 dict key）。
file.close()	file.close() 关闭文件并释放系统资源；关闭后不能再读写，with 语句会自动调用。
file.detach()	file.detach() 把底层二进制缓冲区从文本流中分离；分离后文本流不可再用。
file.fileno()	file.fileno() 返回文件在操作系统层面的整数描述符。
file.flush()	file.flush() 把缓冲区中的数据强制写入磁盘，但不关闭文件。
file.isatty()	file.isatty() 判断文件流是否连接到一个终端设备（tty）。
file.read()	file.read(size=-1) 读取文件内容；size 指定读取的字符数，省略则读取全部。
file.readable()	file.readable() 判断文件是否支持读取。
file.readline()	file.readline(size=-1) 读取一行内容；到达文件末尾时返回空字符串。
file.readlines()	file.readlines(hint=-1) 读取所有行并返回列表，每行保留末尾的换行符。
file.seek()	file.seek(offset, whence=0) 移动文件读写位置；whence 取 0 表示从头、1 从当前位置、2 从末尾。
file.seekable()	file.seekable() 判断文件是否支持随机定位（seek）。
file.tell()	file.tell() 返回当前的文件读写位置。
file.truncate()	file.truncate(size=None) 把文件截断到指定大小；省略 size 时截断到当前位置。
file.writable()	file.writable() 判断文件是否支持写入。
file.write()	file.write(s) 把字符串 s 写入文件；返回实际写入的字符数。
file.writelines()	file.writelines(lines) 把字符串序列逐条写入文件；不会自动添加换行符。
float.as_integer_ratio()	float.as_integer_ratio() 把浮点数表示为精确的分子/分母二元组。
float.is_integer()	float.is_integer() 判断浮点数是否为整数值。
float.hex()	float.hex() 返回浮点数的十六进制字符串表示。
float.fromhex()	float.fromhex(s) 把十六进制字符串转成浮点数（类方法）。
float.conjugate()	float.conjugate() 返回浮点数本身；为兼容复数接口而存在。
for	for 遍历可迭代对象（list/tuple/str/dict/set/生成器）；可与 else 配合（无 break 时执行）。
from	from module import name 把模块中的 name 直接引入当前命名空间。
finally	finally 块无论是否发生异常都会执行；常用于释放资源。
False	False 是 bool 类型的唯一假值实例。
G
getattr()	getattr(obj, name[, default]) 返回 obj 的属性 name；不存在时返回 default（否则抛 AttributeError）。
globals()	globals() 返回当前模块的全局命名空间字典。
global	global name 告诉函数体内的 name 引用模块级全局变量。
H
hasattr()	hasattr(obj, name) 判断 obj 是否有名为 name 的属性。
hash()	hash() 返回对象的整数哈希值（可哈希对象）；相同对象（a is b）一定有相同哈希。
help()	help() 启动交互式帮助；help(obj) 打印 obj 的文档字符串与简要描述。
hex()	hex() 把整数转成以 '0x' 开头的十六进制字符串。
I
id()	id() 返回对象的「身份」整数（通常为其内存地址）。同一对象 is 比较为 True。
input()	input([prompt]) 从 stdin 读取一行（去掉末尾换行）；可选 prompt 先打印再读取。
int()	int() 把数字或字符串转成整数；字符串可指定进制（base）。
isinstance()	isinstance(obj, classinfo) 判断 obj 是否为 classinfo 的实例（或其子类实例），classinfo 可为 tuple。
issubclass()	issubclass(cls, classinfo) 判断 cls 是否为 classinfo 的子类。
iter()	iter(obj) 返回 obj 的迭代器；iter(callable, sentinel) 返回一个迭代器，反复调用 callable 直到返回 sentinel。
int.bit_length()	int.bit_length() 返回表示该整数所需的最小二进制位数。
int.bit_count()	int.bit_count() 返回整数二进制表示中 1 的个数（Python 3.10+）。
int.to_bytes()	int.to_bytes(length, byteorder) 把整数转成指定长度的字节串；byteorder 取 'big' 或 'little'。
int.from_bytes()	int.from_bytes(bytes, byteorder) 把字节串按指定字节序转成整数。
int.as_integer_ratio()	int.as_integer_ratio() 返回 (self, 1) 二元组。
int.conjugate()	int.conjugate() 返回整数本身；该方法为兼容复数接口而存在。
if	if 根据条件真假选择执行分支；可与 elif、else 组合。
import	import 加载一个模块；可指定别名。
L
len()	len() 返回对象的长度（元素个数）。适用于字符串、列表、元组、字典、集合等定义了 __len__ 的对象。
list()	list() 返回可变列表；不传参数返回空列表，传可迭代对象返回元素列表。
locals()	locals() 返回当前作用域的局部命名空间字典。
license()	license() 在交互式解释器中显示完整的 Python 许可证文本（等待回车翻页）。
list.append()	list.append(item) 把 item 追加到列表末尾；原地修改，返回 None。
list.clear()	list.clear() 删除列表中所有元素；等价于 del lst[:]。
list.copy()	list.copy() 返回列表的浅拷贝；等价于 lst[:]。
list.count()	list.count(x) 返回 x 在列表中出现的次数。
list.extend()	list.extend(iterable) 把 iterable 元素逐个追加到列表末尾；等价于 lst += list(iterable)。
list.index()	list.index(x[, start[, end]]) 返回 x 首次出现的索引；找不到抛 ValueError。
list.insert()	list.insert(i, x) 在索引 i 处插入 x；i 越界则插入到两端。
list.pop()	list.pop([i]) 删除并返回索引 i 处元素（默认末尾）；空列表抛 IndexError。
list.remove()	list.remove(x) 删除首次出现的 x；找不到抛 ValueError。
list.reverse()	list.reverse() 原地反转列表；返回 None。
list.sort()	list.sort(*, key=None, reverse=False) 原地排序；返回 None。
lambda	lambda 创建一个匿名函数；只能写单个表达式。
M
map()	map(function, iterable, ...) 把 function 应用到每个元素上，返回迭代器。
max()	max() 返回可迭代对象中的最大元素（或多个参数中的最大者）；可指定 key 函数。
memoryview()	memoryview() 返回对象（如 bytes/bytearray）的内存视图，可零拷贝访问底层缓冲区。
min()	min() 与 max() 类似，返回最小值。
match	match subject 对 subject 做模式匹配，配合 case 分支。
N
next()	next(iterator[, default]) 返回迭代器的下一个元素；耗尽时返回 default（否则抛 StopIteration）。
nonlocal	nonlocal name 告诉函数体内 name 引用最近外层（但非全局）作用域的变量。
None	None 是 NoneType 的唯一实例，常用作「无值」标记；与 False 不同。
NotImplemented	NotImplemented 由二元运算符方法返回，表示「该运算不由我实现，请尝试对调操作数」。
O
object()	object 是所有类的基类；object() 返回一个无特征的对象。
oct()	oct() 把整数转成以 '0o' 开头的八进制字符串。
open()	open() 打开文件，返回 file 对象。强烈建议用 with 语句管理。
ord()	ord(c) 返回单字符 c 的 Unicode 码点整数。
P
pow()	pow(base, exp[, mod]) 返回 base 的 exp 次幂；三参数版本支持模幂运算（更高效）。
print()	print() 把 objects 转为字符串并写到标准输出（默认），sep 分隔、end 结尾、file 重定向。
property()	property(fget, fset, fdel, doc) 把方法封装为可像属性一样访问的对象；也可用 @property 装饰器。
pass	pass 什么也不做；用作语法上必须有语句但逻辑上不需要任何动作的占位。
Q
quit()	quit() 是 exit() 的别名，同样抛 SystemExit。
R
range()	range(stop) 或 range(start, stop[, step]) 返回不可变整数序列对象。常配合 for 循环。
repr()	repr() 返回对象的「官方」字符串表示：理想情况下能传给 eval() 重建该对象。
reversed()	reversed(seq) 返回一个反向迭代器；可用于 list、tuple、str、range 等实现了 __reversed__ 或支持序列协议的对象。
round()	round(number[, ndigits]) 按「银行家舍入」返回指定位数的小数；ndigits 为 None 时返回整数。
return	return 把表达式的值返回给调用者并退出函数；无表达式返回 None。
raise	raise 主动抛出一个异常（可指定类型与消息，或重新抛出当前异常）。
S
set()	set() 返回可变集合；不传参数返回空集合，传可迭代对象去重后返回集合。
setattr()	setattr(obj, name, value) 设置 obj 的属性 name 为 value；等价于 obj.name = value。
slice()	slice(stop) 或 slice(start, stop[, step]) 返回切片对象；用于 list/tuple 等的 __getitem__。
sorted()	sorted(iterable, *, key=None, reverse=False) 返回新排序列表，原对象不变；可指定 key 函数与倒序。
staticmethod()	@staticmethod 把方法标记为静态方法：不接收 self 或 cls。
str()	str() 把对象转成字符串；不传参数返回空串。
sum()	sum(iterable, start=0) 计算可迭代对象元素之和；start 是初始值。不要用 sum 拼接字符串（用 ''.join）。
super()	super() 返回父类的代理对象；可在子类方法中调用父类实现。
str.capitalize()	str.capitalize() 把首字母大写，其余字母小写。
str.casefold()	str.casefold() 返回更适合无大小写比较的小写副本（处理德语 ß 等）。
str.center()	str.center(width[, fillchar]) 返回长度为 width、原串居中、两侧 fillchar 填充的新串。
str.count()	str.count(sub[, start[, end]]) 返回子串 sub 在 [start, end) 区间出现的次数。
str.encode()	str.encode(encoding='utf-8', errors='strict') 把字符串编码成 bytes。
str.endswith()	str.endswith(suffix[, start[, end]]) 判断字符串是否以 suffix 结尾。
str.expandtabs()	str.expandtabs(tabsize=8) 把 tab 字符替换为空格，下一 tab 停在下一 tabsize 边界。
str.find()	str.find(sub[, start[, end]]) 返回 sub 首次出现的索引；找不到返回 -1（不抛异常）。
str.format()	str.format(args, *kwargs) 用占位符 {} 替换成 args/kwargs。
str.index()	str.index(sub) 类似 find()，但找不到时抛 ValueError。
str.isalnum()	str.isalnum() 非空且每个字符都是字母或数字时返回 True。
str.isalpha()	str.isalpha() 非空且每个字符都是字母时返回 True。
str.isascii()	str.isascii() 字符串中所有字符 ASCII（U+0000-U+007F）时返回 True；空串返回 True。
str.isdigit()	str.isdigit() 非空且每个字符都是数字字符（包括 Unicode 数字）时返回 True。
str.islower()	str.islower() 至少有一个小写字母且没有大写字母时返回 True。
str.isspace()	str.isspace() 非空且每个字符都是空白字符（空格、tab、换行等）时返回 True。
str.istitle()	str.istitle() 字符串是 titlecased（每个单词首字母大写，其余小写）时返回 True。
str.isupper()	str.isupper() 至少有一个大写字母且没有小写字母时返回 True。
str.join()	str.join(iterable) 用 str 作为分隔符，把可迭代对象中的字符串拼起来。
str.ljust()	str.ljust(width[, fillchar]) 返回 width 长度、原串左对齐、右侧 fillchar 填充。
str.lower()	str.lower() 返回所有字母小写的副本。
str.lstrip()	str.lstrip([chars]) 去掉左侧 chars（默认空白）字符；与 rstrip/strip 区分。
str.partition()	str.partition(sep) 返回 (before, sep, after) 三元组；找不到 sep 则 (原串, '', '')。
str.replace()	str.replace(old, new[, count]) 返回替换 old 为 new 的副本；count 限制次数。
str.rfind()	str.rfind(sub) 返回 sub 最后一次出现的索引；找不到返回 -1。
str.rindex()	str.rindex(sub) 类似 rfind()，但找不到时抛 ValueError。
str.rjust()	str.rjust(width[, fillchar]) 右对齐，左侧 fillchar 填充。
str.rsplit()	str.rsplit(sep=None, maxsplit=-1) 从右向左拆分；maxsplit 限制拆分次数。
str.rstrip()	str.rstrip([chars]) 去掉右侧 chars（默认空白）。
str.split()	str.split(sep=None, maxsplit=-1) 按 sep 拆分字符串并返回列表；sep=None 时按空白连续拆分。
str.splitlines()	str.splitlines(keepends=False) 按各种换行符拆分多行字符串。
str.startswith()	str.startswith(prefix[, start[, end]]) 判断字符串是否以 prefix 开头。
str.strip()	str.strip([chars]) 去掉两端 chars（默认空白）字符。
str.swapcase()	str.swapcase() 把大写转小写、小写转大写。
str.title()	str.title() 返回每个「单词」首字母大写、其余小写的副本。
str.upper()	str.upper() 返回所有字母大写的副本。
str.format_map()	str.format_map(mapping) 用 mapping 对象（替代 **kwargs）格式化字符串。
str.isdecimal()	str.isdecimal() 非空且每个字符都是十进制数字字符（Unicode Decimal）时返回 True。
str.isidentifier()	str.isidentifier() 字符串是合法的 Python 标识符（变量/函数名）时返回 True。
str.isnumeric()	str.isnumeric() 非空且每个字符都是 Unicode 数字字符（含汉字数字、罗马数字等）时返回 True。
str.isprintable()	str.isprintable() 非空且每个字符都可打印（不含控制字符、不可分空格等）时返回 True。
str.maketrans()	str.maketrans(x[, y[, z]]) 返回一个翻译表给 str.translate() 使用。
str.removeprefix()	str.removeprefix(prefix) 若以 prefix 开头则去掉；否则返回原串（Python 3.9+）。
str.removesuffix()	str.removesuffix(suffix) 若以 suffix 结尾则去掉；否则返回原串（Python 3.9+）。
str.rpartition()	str.rpartition(sep) 从右向左找 sep，返回 (before, sep, after)。找不到返回 ('', '', 原串)。
str.translate()	str.translate(table) 按 table（通常由 str.maketrans 构造）逐字符替换或删除。
str.zfill()	str.zfill(width) 返回宽度 width、左侧补 '0' 的新字符串；保留正负号。
set.add()	set.add(elem) 向集合添加元素；元素已存在则无变化。原地修改。
set.clear()	set.clear() 删除集合所有元素。
set.copy()	set.copy() 返回集合的浅拷贝。
set.difference()	set.difference(*others) 返回在 set 但不在任何 other 中的元素。
set.discard()	set.discard(elem) 删除 elem；不存在不抛错。
set.intersection()	set.intersection(*others) 返回 set 与所有 other 的公共元素。
set.isdisjoint()	set.isdisjoint(other) 判断 set 与 other 是否没有公共元素。
set.issubset()	set.issubset(other) 判断 set 是否为 other 的子集。
set.issuperset()	set.issuperset(other) 判断 set 是否为 other 的超集。
set.pop()	set.pop() 删除并返回任意一个元素；空集合抛 KeyError。
set.remove()	set.remove(elem) 删除 elem；不存在抛 KeyError。
set.symmetric_difference()	set.symmetric_difference(other) 返回在 set 或 other 但不同时在两者的元素。
set.union()	set.union(*others) 返回 set 与所有 other 的并集。
set.update()	set.update(*others) 把 set 与 others 的并集写入 set；原地修改，返回 None。
set.intersection_update()	set.intersection_update(*others) 把 set 与 others 的交集写入 set。
set.difference_update()	set.difference_update(*others) 从 set 中删除 others 共有的元素。
set.symmetric_difference_update()	set.symmetric_difference_update(other) 把 set 与 other 的对称差写入 set。
T
tuple()	tuple() 返回不可变序列；不传参数返回 ()，传可迭代对象返回元素元组。
type()	type(obj) 返回对象的类型；type(name, bases, dict) 动态创建一个新类。
tuple.count()	tuple.count(x) 返回 x 在元组中出现的次数。
tuple.index()	tuple.index(x[, start[, end]]) 返回 x 首次出现的索引；找不到抛 ValueError。
try	try 包裹可能抛异常的代码；except 处理异常、finally 清理资源。
True	True 是 bool 类型的唯一真值实例。
V
vars()	vars() 不传参数等价于 locals()；传对象返回对象的 __dict__。
W
while	while 在条件为真时反复执行循环体；可用 continue / else。
with	with 语句在进入和退出代码块时调用上下文管理器的 __enter__ / __exit__；常用于文件/锁/连接。
Y
yield	yield 把函数变成生成器；每次 next() 时函数执行到 yield 处返回值并暂停。
Z
zip()	zip(*iterables) 把多个可迭代对象「并行」组合成元组迭代器（按最短截断）；strict=True 时要求等长。

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。

关于我们

参考手册

参考手册

🙏 帮我们做得更好