# Python itertools.groupby 参考

URL: https://caijiao.org/reference/python/itertools-groupby
Source: docs/reference/python/itertools-groupby.md
Description: Python itertools.groupby 参考，整理标准库调用语法、参数、示例、返回值和常见错误。

Python itertools.groupby 参考，整理标准库调用语法、参数、示例、返回值和常见错误。

## 语法

```python
from itertools import groupby

groups = groupby(items, key=key_func)
```

## 参数

- `iterable`：输入迭代器或序列。
- `n / key`：控制截取数量、组合大小或分组键。

## 返回值

返回惰性迭代器，通常需要 list、for 循环或 next 消费。

## 示例

```python
from itertools import groupby

for key, group in groupby(["a", "aa"], key=len):
    print(key, list(group))
```

## 常见错误

- 迭代器只能消费一次，调试时转成 list 会耗尽它。
- groupby 只合并相邻元素，通常需要先排序。

## 相关内容

- [Python 教程](/python/)
- [Python 问题库](/how-to/python/)
- [JSON Formatter](/tool/json-formatter)
- [Timestamp Converter](/tool/timestamp-converter)