---
title: "chunk"
description: "将数组分割成指定大小的子数组块，常用于分页展示、批量处理和数据分片场景。"
seo_title: "chunk"
seo_description: "Split an array into smaller arrays of a fixed size, returning a new array of chunks without mutating the original input array."
canonical_url: "https://core.mhaibaraai.cn/docs/utilities/array/chunk"
---
# chunk

> 将数组分割成指定大小的子数组块，常用于分页展示、批量处理和数据分片场景。

## 用法

`chunk` 函数用于将一个数组分割成多个指定大小的子数组，常用于分页、批处理等场景。

```ts
import { chunk } from '@movk/core'

const numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9]
const chunks = chunk(numbers, 3)
console.log(chunks) // [[1, 2, 3], [4, 5, 6], [7, 8, 9]]

const names = ['Alice', 'Bob', 'Charlie', 'David', 'Eve']
const pairs = chunk(names, 2)
console.log(pairs) // [['Alice', 'Bob'], ['Charlie', 'David'], ['Eve']]
```

## API

### `chunk<T>(arr, size)`

将数组分割成指定大小的块。

### 参数

**arr** (`T[]`) *required*: 待分割的数组。

**size** (`number`) *required*: 每个块的大小。

### 返回值

**返回值** (`T[][]`): 分割后的二维数组，每个子数组的长度不超过 size。

## Changelog

See commit history for [src/utilities/array/chunk.ts](https://github.com/mhaibaraai/movk-core/commits/main/src/utilities/array/chunk.ts).


## Sitemap

See the full [sitemap](/sitemap.md) for all pages.