repeat按轴逐元素复制,支持不均匀重复;tile按块整体复制,保持维度结构;二者行为本质不同,用错会导致形状错误。

repeat 和 tile 都能复制数组元素,但行为完全不同:前者按轴“拉伸”元素,后者按“铺砖”方式重复整个数组结构;用错一个,结果可能完全不是你想要的形状。
repeat 是按 axis 逐元素复制,返回一维展开结果(默认)
当你想把 a = np.array([1, 2, 3]) 变成 [1, 1, 2, 2, 3, 3],就该用 repeat。它不关心维度结构,只对指定轴上的每个元素执行重复操作。
常见错误是忽略 axis 参数导致意外展平:
- 不传
axis:np.repeat([[1,2],[3,4]], 2)→[1 1 2 2 3 3 4 4](先 ravel 再 repeat) - 传
axis=0:np.repeat([[1,2],[3,4]], 2, axis=0)→[[1,2],[1,2],[3,4],[3,4]] - 传
axis=1:np.repeat([[1,2],[3,4]], 2, axis=1)→[[1,1,2,2],[3,3,4,4]]
repeats 参数支持整数或数组,比如 np.repeat([1,2,3], [2,1,3]) 得到 [1,1,2,3,3,3] —— 这点 tile 做不到。
tile 是按块复制整个数组,保持原始维度语义
tile 的设计目标是“复制一份完整副本”,比如把 [1,2] 变成 [1,2,1,2,1,2](重复 3 次),或者把 [[1,2],[3,4]] 按 (2,3) 铺成 2 行 × 3 列的块阵列。
关键点在于 reps 参数是元组,长度必须 ≥ 输入数组维数,不足会自动左补 1:
-
np.tile([1,2], 3)→[1,2,1,2,1,2](reps=(3,),等价于(1,3)) -
np.tile([[1,2],[3,4]], (2,1))→ 2 行 × 1 列块:[[1,2],[3,4],[1,2],[3,4]] -
np.tile([[1,2]], (2,3))→[[1,2,1,2,1,2],[1,2,1,2,1,2]]
注意:tile 不接受 per-element 重复数,也不支持 axis 参数 —— 它只认“整体怎么铺”。
repeat 和 tile 在二维数组上最容易混淆的场景
假设你有 a = np.array([[10, 20]])(1×2),想得到 3 行、每行都是 [10,20]:
- ✅ 正确:
np.tile(a, (3, 1))→ 形状(3, 2) - ❌ 错误:
np.repeat(a, 3, axis=0)→ 形状(3, 2)?不对,这是[[10,20],[10,20],[10,20]],看起来一样,但逻辑不同:它是把第一行重复 3 次;如果原数组是[[10,20],[30,40]],repeat(..., axis=0)会重复两行,而tile(..., (3,1))是把整个 2×2 块铺 3 行。 - ⚠️ 更危险的是:
np.repeat(a, 3)(无 axis)→[10,10,10,20,20,20],形状直接变成一维,容易引发后续计算报错。
性能上,tile 通常比等效的 repeat + reshape 组合更直观、更少出错;但若你需要非均匀重复(如第 0 元素重复 2 次、第 1 元素重复 5 次),只能靠 repeat。
遇到 shape 不匹配报错时,先检查 axis 和 reps 维度
典型报错如 ValueError: axis 2 is out of bounds for array of dimension 2,说明你给 repeat 传了超维 axis;或者 tile 报 reps must be a sequence,其实是传了 int 而非 tuple。
调试建议:
- 打印原数组
shape和ndim - 对
repeat:确认axis在[-ndim, ndim-1]范围内 - 对
tile:确保reps是 tuple,且len(reps) >= a.ndim;不够就补前导 1,比如 2D 数组配(3,)等价于(1,3)
最常被忽略的是:二者都不做广播,也不会自动对齐维度;所有重复逻辑都严格基于当前 shape 和参数,差一个括号、少一个逗号,结果就可能天差地别。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











