n8n 資料結構：items、JSON 與節點如何處理多筆資料

學 n8n 最重要、也最容易卡關的觀念就是：節點之間傳遞的不是一筆資料，而是一個由多筆資料組成的清單（items）。

items 長什麼樣子

節點的輸出在 JSON 檢視中長這樣：

[
  { "name": "小明", "email": "ming@example.com" },
  { "name": "小華", "email": "hua@example.com" },
  { "name": "小美", "email": "mei@example.com" }
]

這是 3 個 items。在 n8n 內部，每個 item 其實是：

{
  "json": { "name": "小明", "email": "ming@example.com" },
  "binary": { }
}

這是 n8n 最重要的規則。假設上一個節點輸出 3 筆資料，下一個是「Send Email」節點：

[Google Sheets] ──3 items──▶ [Send Email]
                               寄出 3 封信（每一筆一封）

你不需要寫迴圈，n8n 會自動處理。Send Email 節點中的 {{ $json.email }}，在處理第一筆時是 ming@example.com，第二筆時是 hua@example.com，以此類推。

節點右上角顯示的數字（例如 3 items）就是輸出的筆數。

最常見的原因：上游節點輸出了 5 個 items，下游的「發送訊息」節點就執行了 5 次。解決方法：

HTTP Request 取得的資料常常是「一筆 item，裡面有一個陣列」：

[
  {
    "results": [
      { "id": 1, "title": "文章 A" },
      { "id": 2, "title": "文章 B" }
    ]
  }
]

這時下游節點只會執行一次。加一個 Split Out 節點，欄位填 results，就會變成兩筆：

[
  { "id": 1, "title": "文章 A" },
  { "id": 2, "title": "文章 B" }
]

n8n 會記住每一筆輸出資料是由哪一筆輸入資料產生的。因此在後面的節點中，可以取得同一筆資料在之前某個節點的值：

{{ $('Google Sheets').item.json.name }}

意思是：「對應到目前這筆資料的，那一筆在 Google Sheets 節點中的 name」。運算式的完整說明見運算式教學。

當流程分成兩條路，又要合在一起時，使用 Merge 節點：

模式	說明
Append	把兩邊的資料接在一起
Combine by matching fields	依照共同欄位合併（類似 SQL 的 JOIN），例如用 email 對應客戶資料與訂單
Combine by position	第一筆配第一筆、第二筆配第二筆
Choose branch	等兩邊都完成後，只輸出其中一邊

讀取檔案、下載圖片、收到附件時，資料會放在 binary 中，在 OUTPUT 的 Binary 分頁可以預覽或下載。常用節點：

更新於 2026年10月12日