---
id: ios-uikit-autolayout-patterns
title: UIKit AutoLayout 실전 패턴
category: Coding
status: draft
source_trust_level: B
verification_status: conceptual
created_at: 2026-05-09
updated_at: 2026-05-09
tags: [ios, uikit, autolayout, layout, vibe-coding]
tech_stack: { language: "Swift / UIKit", applicable_to: ["iOS"] }
applied_in: []
aliases: [NSLayoutAnchor, priority, content hugging, compression resistance]
---

# UIKit AutoLayout 실전 패턴

> AutoLayout 의 어려움은 (1) anchor / constraint API 자체가 아니라 (2) **priority + hugging + compression resistance** 의 의미와 (3) **runtime 충돌 디버깅**.

## 📖 핵심 개념
- Constraint 는 식: `view1.attribute = m * view2.attribute + c`
- Priority 1~1000: 1000 = required, 그 외 = optional. 충돌 시 priority 높은 게 이김.
- Content hugging: "내가 늘어나기 싫어" 강도.
- Compression resistance: "내가 줄어들기 싫어" 강도.

## 💻 코드 패턴

### NSLayoutAnchor (UIKit native)
```swift
view.translatesAutoresizingMaskIntoConstraints = false
NSLayoutConstraint.activate([
    view.topAnchor.constraint(equalTo: superview.safeAreaLayoutGuide.topAnchor, constant: 16),
    view.leadingAnchor.constraint(equalTo: superview.leadingAnchor, constant: 16),
    view.trailingAnchor.constraint(equalTo: superview.trailingAnchor, constant: -16),
    view.heightAnchor.constraint(equalToConstant: 44),
])
```

### Stack views (제일 자주 쓰임)
```swift
let stack = UIStackView(arrangedSubviews: [titleLabel, subtitleLabel, button])
stack.axis = .vertical
stack.spacing = 8
stack.alignment = .fill
view.addSubview(stack)
// stack 자체만 외부 constraint
```

### Hugging / Compression — 두 label 한 줄에
```swift
// 길어지면 잘리지 말아야 할 쪽
priceLabel.setContentCompressionResistancePriority(.required, for: .horizontal)
nameLabel.setContentCompressionResistancePriority(.defaultLow, for: .horizontal)
// → name 이 "..." 잘림, price 는 풀 표시
```

### 동적 height (multiline label)
```swift
descriptionLabel.numberOfLines = 0 // 무제한
// width 만 제약, height 는 알아서
descriptionLabel.widthAnchor.constraint(equalTo: view.widthAnchor, constant: -32).isActive = true
```

### 런타임 충돌 디버그
```swift
// 충돌 시 콘솔에 "Will attempt to recover by breaking constraint ..."
// 해당 constraint 에 identifier 부여 → 추적 쉬움
let c = view.heightAnchor.constraint(equalToConstant: 44)
c.identifier = "RowMinHeight"
c.isActive = true
```

## 🤔 의사결정 기준
| 레이아웃 | 권장 |
|---|---|
| 정렬·간격 단순 | UIStackView |
| 복잡 비율 (golden ratio 등) | NSLayoutAnchor + multiplier |
| 외부 라이브러리 OK | SnapKit (가독성↑) |
| 동적 height (table cell) | label numberOfLines 0 + UITableView.automaticDimension |
| 안전영역 / 노치 | safeAreaLayoutGuide |
| 키보드 회피 | NSLayoutConstraint constant 변경 + animation |

## ❌ 안티패턴
- **translatesAutoresizingMaskIntoConstraints 끄기 잊음**: 자동 frame constraint 가 충돌. 먼저 false.
- **frame + autolayout 혼용**: 한 view 는 한 모델. layoutSubviews 에서 frame 조작 시 autolayout 깨짐.
- **모든 priority required**: 첫 충돌에 앱 crash.
- **stack view 안에 0 spacing 으로 또 stack**: 가독성 떨어짐. 설계 재고.
- **safeAreaLayoutGuide 무시**: 노치 / Dynamic Island 위에 그림.
- **dynamic type 무시 (큰 글씨 설정)**: label 잘림. preferredFont(forTextStyle:) + adjustsFontForContentSizeCategory.
- **다국어 RTL 무시**: leading/trailing (NOT left/right).

## 🤖 LLM 활용 힌트
- "leading/trailing 사용 (RTL 자동), top/bottom" 명시.
- 복잡 layout 은 SnapKit 또는 Stack View first.

## 🔗 관련 문서
- [[iOS_SwiftUI_State_Property_Wrappers]]
- [[iOS_SwiftUI_Lifecycle_View_Identity]]
