从列表获取一个元素

📖 节点概述

通过索引从列表中获取单个元素。支持负索引（-1 表示最后一个元素）。输入列表可以来自连线（列表对象或 JSON 字符串），也可以手动输入（每行一个元素）。索引越界时返回 None。该节点为纯数据节点，无执行端口。

💡 使用场景：

• 取第一个/最后一个元素：索引 0 或 -1 快速获取边界元素。
• 按位置提取数据：从固定格式列表中获取特定字段（如从配置列表取第二个参数）。
• 循环中按索引访问：配合【遍历列表】节点的当前索引，获取其他相关列表的对应元素。
• 解析索引值：从变量中读取动态索引，再从列表中取值。
• 列表数据分拆：取出某个元素后继续处理，剩余部分可用切片节点获取。

🎮 实战连线指南：如何正确使用它？

节点有两个输入端口：列表 和 索引，输出端口 元素。

场景案例：获取水果列表中的第二个元素

1. 准备列表：可以手动在“列表”多行文本框输入：

   apple
   banana
   cherry
   

   或从连线传入列表 ["apple", "banana", "cherry"]。

2. 设置索引：在“索引”输入框中填写 1（因为索引从 0 开始）。

3. 获取结果：元素 输出 "banana"。

4. 后续使用：将该元素用于显示或判断。

负索引示例：

• 列表 ["a","b","c"]，索引 -1 → 输出 "c"（最后一个）。
• 索引 -2 → 输出 "b"。

索引越界：

• 列表长度为 3，索引 5 或 -5 → 输出 None。

⚙️ 引脚与参数说明

📥 输入引脚

⚙️ 控件参数

📤 输出引脚

🔧 列表输入格式说明

节点 _to_list() 方法支持以下输入格式（按优先级）：

• 直接传入 Python 列表对象。
• 合法的 JSON 字符串，如 ["apple","banana"]。
• 多行文本：每行一个元素（空行会被忽略），例如：

  apple
  banana
  cherry
  

• 其他类型的输入会被包裹为单元素列表（例如数字 123 → [123]）。
• 空值或空字符串返回空列表 []。

这种设计使得节点既可以接收结构化数据，也便于快速测试时手动输入。

⚠️ 注意事项

• 索引越界：不会报错，返回 None。建议在取值后使用【条件判断】节点检查是否为 None。
• 列表为空：任何索引均返回 None。
• 负索引：-1 表示最后一个元素，-2 表示倒数第二个，依此类推。负索引的绝对值不能大于列表长度，否则越界返回 None。
• 类型转换：索引输入会先转为字符串再尝试转为整数；无法转换时默认为 0。
• 多行文本解析：仅按行拆分，不会解析行内逗号等。如需复杂结构，请使用 JSON 格式。
• 输出类型：输出类型为 ANY（任意类型），颜色为灰色，表示可能是字符串、数字、列表等。

💎 小贴士：

• 常见用法：取第一个元素（索引 0），取最后一个元素（索引 -1）。
• 如果需要同时获取多个元素（如切片），请使用【截取列表】节点。
• 若索引是动态计算出来的（比如从【字符串长度】或【数学运算】获得），可直接连线到“索引”端口。
• 返回 None 的情况可用于分支判断：例如如果元素不为 None 才继续处理。
• 结合【Range 生成器】生成的索引列表，可以批量取多个位置的值（需配合【遍历列表】）。