`len()` 是 Python 的**内置函数（Built-in Function）**，无需导入任何模块即可直接调用，属于语言核心运行时环境的一部分，其定义位于 CPython 解释器的底层实现中（C 源码 `Objects/abstract.c` 中的 `PyObject_Size` 接口封装），对用户完全透明且全局可用 [ref_1]。 --- ### 一、`len()` 的语义定位与存在位置 | 维度 | 说明 | |------|------| | **语言层级** | Python 核心内置函数，与 `print()`, `type()`, `input()` 同属一类 [ref_5] | | **作用域** | 全局作用域，任意模块、函数、交互式环境（如 IDLE、Jupyter、IPython）中均可直接调用 | | **实现位置** | CPython 源码中由 `builtin_len()` 函数实现，通过 `__len__()` 魔术方法协议调度 [ref_1] | | **调用前提** | 对象必须实现 `__len__()` 方法（即支持“长度”语义），否则抛出 `TypeError` | > ✅ 所有标准容器类型（`str`, `list`, `tuple`, `dict`, `set`, `bytes`, `range`）均实现了 `__len__()`，因此 `len()` 对它们全部有效 [ref_3][ref_4]。 --- ### 二、`len()` 的基础语法与典型用法 ```python # 字符串长度（Unicode 码点个数） len("Hello") # → 5 len("你好") # → 2（不是字节数，是字符数） # 列表/元组元素个数 len([1, 2, 3, 4]) # → 4 len((10, 20)) # → 2 # 字典键值对数量 len({"a": 1, "b": 2}) # → 2 # 集合元素数 len({1, 2, 2, 3}) # → 3（自动去重） # range 对象的逻辑长度（不生成实际列表） len(range(0, 100, 3)) # → 34（0,3,6,...,99） ``` > ⚠️ 注意：`len(None)`、`len(42)`、`len(lambda x: x)` 均触发 `TypeError: object of type 'xxx' has no len()` [ref_5]。 --- ### 三、`len()` 的底层机制：协议驱动 `len(obj)` 实际等价于调用 `obj.__len__()` —— 这是 Python 的**数据模型协议**。用户可自定义类支持 `len()`： ```python class BookShelf: def __init__(self, books): self.books = books # list of str def __len__(self): return len(self.books) # 必须返回非负整数 shelf = BookShelf(["Python Crash Course", "Fluent Python"]) print(len(shelf)) # → 2，成功调用自定义 __len__ ``` 该机制印证 `len()` 并非“硬编码类型判断”，而是统一的鸭子类型协议调用 [ref_1]。 --- ### 四、常见误用与性能事实 | 场景 | 正确做法 | 错误认知 | 依据 | |------|----------|-----------|------| | 判断空容器 | `if len(lst) == 0:` ❌<br>`if not lst:` ✅ | 认为 `len()` 更直观 | `len()` 是 O(1) 操作（所有内置容器缓存长度），但布尔上下文更语义清晰且高效 [ref_2] | | 获取字符串字节数 | `len(s.encode('utf-8'))` ✅ | 误用 `len(s)` 当字节数 | `len("€")` 是 1（字符），但 `len("€".encode())` 是 3（UTF-8 字节）[ref_3] | | 在循环中反复调用 | `for i in range(len(lst)):` ✅（仅当需索引）<br>`for item in lst:` ✅✅（推荐） | 认为必须用 `len()` 控制循环 | Python 迭代协议更安全、更 Pythonic [ref_4] | --- ### 五、快速验证 `len()` 存在性的交互式检测 ```python # 查看是否为内置函数 import builtins print('len' in dir(builtins)) # → True # 查看文档 print(len.__doc__) # 输出：Return the number of items in a container. # 查看签名 import inspect print(inspect.signature(len)) # → (obj, /) ``` 此验证直接证明 `len` 是 `builtins` 模块导出的原生函数，而非第三方库或用户定义符号 [ref_2]。 --- 综上，`len()` 的“位置”是三重嵌套的： ① **语法层**：作为关键字级函数存在于所有 Python 运行环境中； ② **实现层**：由 CPython 解释器在启动时注入 `builtins` 命名空间； ③ **协议层**：通过 `__len__()` 魔术方法向任意对象开放长度语义 [ref_1][ref_5]。