macos快捷指令中字典用键存取值、数组按序存项目，需用“获取词典值”提取字段，“为每个项目重复”遍历数组，嵌套时分步处理，调试用“显示结果”确认结构。
macos 快捷指令里处理字典（dictionary）和数组（list）是实现动态数据流转的关键。它们不是普通文本，而是结构化容器：字典用键（key）存取值（value），数组按顺序存放多个项目。理解两者区别和配合方式，才能稳定解析 api 返回内容、批量处理数据或构建条件逻辑。
识别和提取字典中的值
很多网络请求（比如调用 Typicode API）返回的是 JSON 格式，快捷指令会自动转为字典。要拿到其中某个字段，必须用“获取词典值”操作：
- 确保前一个操作输出是字典（例如“获取 URL 内容”+“JSON”解析后）
- 添加“获取词典值”，在“键”栏填准确的字段名，比如 name、email 或 id（区分大小写，且不能带空格或引号）
- 如果键不存在，该操作会输出空值，不会报错——适合做安全读取
- 嵌套字典需分步提取：先取外层键得到子字典，再对它执行一次“获取词典值”
遍历数组中的每一项
API 响应常以数组形式返回多条记录（如用户列表）。快捷指令不支持直接“for 循环”，但有两个核心操作对应不同需求：
- 用“从列表中获取项目”选中特定位置的项（索引从 0 开始），适合只处理第一个、最后一个或固定序号的数据
- 用“为每个项目重复”包裹后续操作，让里面的内容逐项运行一次——这是真正意义上的循环，常配合“获取词典值”提取每项的字段
- 注意：“为每个项目重复”内部的操作只能访问当前迭代项，不能直接引用外部变量，如需累积结果，得用“追加到列表”等操作手动收集
组合字典与数组做实际任务
真实场景中二者经常嵌套出现。例如获取一组文章数据（数组），每篇文章是个字典（含 title、body、author）。典型处理链路是：
- “获取 URL 内容” → “将 JSON 转为字典/列表”（系统自动识别）
- “为每个项目重复” → 进入循环体
- 在循环内加“获取词典值”，键设为 title，输出就是当前文章标题
- 可接“显示通知”或“追加到列表”，把所有标题收集成新数组再统一处理
- 若只需第一条，就跳过“为每个项目重复”，改用“从列表中获取项目”（索引 0），再连“获取词典值”
调试小技巧：验证数据结构
不确定输出是字典还是数组？或者键名记不清？可以临时加一步：
- 在关键节点后插入“显示结果”操作（或“显示通知”），运行看实际内容
- 字典显示为 {key: value, ...}，数组显示为 [item1, item2, ...]
- 对数组点开预览，能看到索引和每个项目的类型；对字典点开，能列出所有可用键
- 避免凭空猜测键名，尤其第三方 API 响应可能含下划线、驼峰或缩写（如 user_name 或 userName）
