# 获取首个元素

使用 lodash _.head 获取数组的第一个元素

> 标准页面: https://elysiatools.com/zh/tools/head-item

- **分类:** Data Processing

- **关键词:** 数组, 首个, 第一个, 元素, lodash, 访问

## 概述

检索数组的第一个元素。

## 功能特性：
- 获取任意数组的第一个元素
- 空数组返回 undefined
- 处理任何数据类型的数组
- 简单直接的操作
- 使用 lodash _.head 进行可靠访问

## 示例：
- 输入：[1, 2, 3] → 输出：1
- 输入：["a", "b", "c"] → 输出："a"
- 输入：[{id: 1}, {id: 2}] → 输出：{id: 1}
- 输入：[] → 输出：undefined

## 使用场景：
- **快速预览**：预览集合的第一个项目
- **数据验证**：检查数据的第一个元素
- **数组处理**：单独处理前导元素
- **队列操作**：查看队列的前端

## 输入项

- **数组输入** (textarea): 输入有效的 JSON 数组

## 适用场景

- 需要快速预览集合中的首个项目时
- 在处理队列或堆栈数据结构时查看前端元素
- 对数组进行逻辑拆分，需单独提取前导数据进行验证时

## 工作原理

- 在输入框中粘贴有效的 JSON 数组格式数据。
- 工具会自动调用 lodash _.head 方法进行解析。
- 系统将立即返回数组的第一个元素，若数组为空则返回 undefined。

## 使用案例

- 快速预览集合的首个项目
- 验证数据结构中的首个元素是否符合预期
- 从队列数据中提取待处理的首个任务

## 常见问题

### 如果输入的数组为空，结果是什么？

如果输入的是空数组 []，工具将返回 undefined。

### 该工具支持哪些数据类型？

支持包含数字、字符串、对象或嵌套数组等任何有效 JSON 数据类型的数组。

### 为什么需要使用这个工具而不是手动查找？

对于大型数据集或复杂的嵌套结构，使用工具可以避免人工查找错误，确保提取过程高效且准确。

### 该工具是否会修改原始数组？

不会，该工具仅读取数组并返回第一个元素，不会对原始数据进行任何更改。

### 输入格式有什么要求？

输入必须是标准的 JSON 数组格式，例如 [1, 2, 3] 或 [{"id": 1}, {"id": 2}]。

## 相关工具

- [查找键](https://elysiatools.com/zh/tools/find-key): 使用 lodash _.findKey 查找第一个匹配的键
- [路径取值](https://elysiatools.com/zh/tools/get-path): 使用 lodash _.get 按路径取值
- [查找索引](https://elysiatools.com/zh/tools/index-of): 使用 lodash _.indexOf 查找值在数组中的索引
- [获取除最后一个元素](https://elysiatools.com/zh/tools/initial-items): 使用 lodash _.initial 获取除最后一个元素外的所有元素
- [第 N 项](https://elysiatools.com/zh/tools/nth-item): 使用 lodash _.nth 获取指定索引的元素
- [排序插入索引](https://elysiatools.com/zh/tools/sorted-index): 使用 lodash _.sortedIndex 查找排序数组插入索引
- [数组尾部](https://elysiatools.com/zh/tools/tail-items): 使用 lodash _.tail 获取数组除首项外的元素
- [取前几项](https://elysiatools.com/zh/tools/take-items): 使用 lodash _.take 获取数组前 N 项

## 示例

- [Grafana 高级应用示例](https://elysiatools.com/zh/samples/grafana-samples): 全面的 Grafana 示例，涵盖高级仪表板设计、告警配置、数据源集成和插件开发
- [二维码示例](https://elysiatools.com/zh/samples/qrcode-samples): 用于测试二维码读取和生成工具的示例二维码图像
- [D3.js 数据可视化示例](https://elysiatools.com/zh/samples/d3js-data-visualization): 全面的D3.js数据可视化示例，包括图表、地图、动画和交互式可视化
- [Rome JavaScript 工具链示例](https://elysiatools.com/zh/samples/rome): Rome JavaScript 工具链示例，包括配置、代码检查、格式化、打包和项目管理