# 목록 병합

> 여러 목록을 하나로 합치세요. 이어 붙이기는 연결한 순서대로 목록을 덧붙이고, Zip은 같은 위치의 항목을 병합합니다. 중복을 제거할 수도 있습니다.

Source: https://nodaro.ai/ko/docs/nodes/automate/merge-lists

**목록 병합** 노드는 여러 목록을 하나로 합칩니다. **이어 붙이기**는 연결한 순서대로 목록을 하나씩 덧붙입니다. <strong>Zip(항목별 병합)</strong>은 같은 위치에 있는 항목을 항목 하나로 병합합니다. Zip을 사용하면 공유 객체 하나를 더 긴 목록의 모든 항목에 더할 수 있습니다. 선택 사항인 스위치를 켜면 병합 후 중복을 제거합니다. 이 노드는 무료입니다.

- Found in: Automate › Lists & Batching
- Output: data
- API type: `merge-lists`

## 사용 시기
- 두 번의 스크래핑 결과를 목록 하나로 합칩니다.
- 두 출처의 프롬프트를 일괄 처리 하나로 합칩니다.
- 브랜드 정보처럼 같은 설정 객체를 제품 목록의 모든 항목에 더합니다.

## 빠른 시작
### 노드 추가
캔버스에서 Tab 키를 누르고 **자동화 › 목록 및 일괄 처리 › 목록 병합**을 선택하세요.

### 목록 두 개 이상 연결
각 목록을 **목록** 입력에 연결하세요. **이어 붙이기**에서는 첫 번째 연결의 항목이 맨 앞에 옵니다.

### 모드 선택
설정 패널을 열고 **이어 붙이기**나 <strong>Zip(항목별 병합)</strong>을 고르세요. 반복 항목을 제외하려면 **병합 후 중복 제거**를 켜세요.

### 실행
**병합됨** 출력에 합쳐진 목록이 담깁니다. 실행이 끝나면 패널에 처음 몇 개 항목의 미리 보기와 항목 수가 표시됩니다.

Workflow: 목록에 입력한 프롬프트와 스크립트에서 나눈 프롬프트가 일괄 처리 하나가 되고, 이미지 생성이 프롬프트마다 한 번씩 실행됩니다.

- 목록 → 목록 병합 (목록)
- 텍스트 분할 → 목록 병합 (목록)
- 목록 병합 → 이미지 생성 (프롬프트 · 개별)

## 입력과 출력
| 입력 또는 출력 | 받거나 보내는 것 | 하는 일 |
| --- | --- | --- |
| **목록** | 목록 두 개 이상 | 합칠 목록입니다. 값 하나를 보내는 노드는 항목이 하나인 목록으로 취급됩니다. **목록 병합**은 **개별** 모드의 연결에서도 항상 전체 목록에 대해 한 번만 실행됩니다. |
| **병합됨** | 목록 | 합쳐진 목록입니다. |

## 설정
| 설정 | 하는 일 |
| --- | --- |
| **모드** | 기본값인 **이어 붙이기**는 연결 순서대로 목록을 덧붙입니다. <strong>Zip(항목별 병합)</strong>은 같은 위치의 항목을 병합합니다. Zip 모드에서는 짧은 목록이 첫 항목부터 다시 시작하며, 객체 하나는 긴 목록의 모든 항목에 병합됩니다. |
| **병합 후 중복 제거** | 기본값은 **꺼짐**입니다. **켜짐**이면 병합 후 값을 비교해 반복 항목을 제외합니다. |

## Zip의 항목 병합 방식
Zip은 JSON 객체 목록을 위해 만들어졌습니다. 제품 목록과 공유 객체 하나가 있으면, 모든 제품이 공유 필드를 받습니다.

| 연결 | 값 |
| --- | --- |
| 첫 번째 목록 | `[{ "name": "Mug" }, { "name": "Cap" }]` |
| 두 번째 연결 | `{ "brand": "Nodaro" }` |
| **병합됨** 출력 | `[{ "name": "Mug", "brand": "Nodaro" }, { "name": "Cap", "brand": "Nodaro" }]` |

## 크레딧
목록 병합은 무료입니다.

## 팁
- **원하는 순서대로 연결하세요.** 이어 붙이기는 연결 순서를 따르므로, 맨 앞에 와야 할 목록을 다른 목록보다 먼저 연결하세요.
- **필드로 비교하세요.** **병합 후 중복 제거**는 항목 전체를 비교합니다. `id`가 같은 항목을 중복으로 처리하려면 목록 병합 뒤에 [중복 제거](https://nodaro.ai/docs/nodes/automate/remove-duplicates)를 두세요.
- **단일 결과를 모으세요.** 목록이 아니라 여러 노드의 단일 결과를 모으려면 [수집](https://nodaro.ai/docs/nodes/automate/collect)을 사용하세요.

## 자주 묻는 질문

### 목록 병합의 이어 붙이기와 Zip은 어떻게 다른가요?

이어 붙이기는 연결한 순서대로 목록을 하나씩 덧붙입니다. Zip은 같은 위치에 있는 항목을 항목 하나로 병합하므로, 항목이 5개인 목록 두 개에서 병합된 항목 5개가 나옵니다.

### Zip 모드에서 목록의 길이가 다르면 어떻게 되나요?

짧은 목록은 가장 긴 목록이 끝날 때까지 첫 항목부터 다시 시작합니다. 한 연결에서 들어온 객체 하나는 긴 목록의 모든 항목에 병합됩니다.

### 목록 병합으로 중복을 제거할 수 있나요?

네. “병합 후 중복 제거”를 켜면, 목록을 병합한 뒤 값이 같은 반복 항목을 제외합니다. 기본적으로 꺼져 있습니다.

### 목록 병합에 크레딧이 드나요?

아니요. 목록 병합은 무료입니다.