[iOS / Swift] 테이블뷰와 컬렉션뷰의 갱신 메서드

iOS에서 피드처럼 스크롤 가능한 리스트 화면을 만들 때는 보통 UITableView나 UICollectionView를 사용합니다.

이 두 뷰는 한 번 표시된 화면을 자동으로 갱신하지 않기 때문에, 데이터가 바뀌면 개발자가 직접 갱신 메서드를 호출해야 합니다.

 

대표적인 갱신 메서드는 총 네 가지인데요. 차례대로 하나씩 살펴봅시다!

 

🍎 reloadData()

reloadData()는 UITableView나 UICollectionView에서 현재 표시 중인 모든 셀과 섹션을 완전히 다시 그리는 메서드입니다.

 

공식 문서를 살펴보면…

“Call this method when the data in your data-source object changes or when you want to force the collection view to update its contents.”

— Apple Developer Documentation

 

즉, 데이터 소스의 내용이 바뀌었거나, 화면을 강제로 새로고침해야 할 때 호출하는 메서드입니다.

 

reloadData()의 내부 동작

reloadData()를 호출하면 다음 순서로 동작하게 되는데요.

1. 기존 셀과 섹션의 정보를 모두 제거합니다.
2. 데이터소스(UITableViewDataSource)의
3. numberOfSections(in:)과 tableView(_:numberOfRowsInSection:)를 다시 호출합니다.
4. 각 셀을 다시 요청하기 위해 cellForRowAt이 모든 인덱스에 대해 실행됩니다.
5. 테이블뷰가 새 셀을 구성하고 전체 화면을 다시 렌더링합니다. 

결과적으로 화면이 전체 리로드 되며, 이전 셀의 상태나 스크롤 위치 등이 초기화될 수 있습니다.

사용 예시

SNS처럼 여러 게시글을 보여주는 커뮤니티 피드 앱을 생각해볼까요?

새로운 게시글이 업로드되면 전체 피드를 다시 불러와야겠죠!

var posts = ["아요 과제 언제하지 ㅠㅠ", "스유공부 시작했어요!!"]

func addPost(_ newPost: String) {
    posts.append(newPost)
    tableView.reloadData()
}

 

이때 reloadData()를 사용하면, 테이블뷰가 새로운 데이터를 포함해 전체 피드를 다시 표시합니다.

 

주의할 점

reloadData()를 사용할 때는 몇 가지 주의할 점이 있습니다.

• 모든 셀을 다시 그리기 때문에, 데이터가 많을 경우 성능 부담이 큽니다.
• 애니메이션 없이 즉시 갱신되어 화면이 순간적으로 깜빡일 수 있습니다.
• 셀을 삽입하거나 삭제하는 중(beginUpdates() 내부 등)에는 사용하지 않아야 합니다.
• 데이터소스의 행 수와 실제 뷰의 행 수가 일치하지 않으면 크래시가 발생할 수 있습니다.

즉, reloadData()는 간단하고 빠르지만 부분 업데이트가 필요한 상황에서는 비효율적이겠죠!

데이터가 자주 바뀌는 피드 화면이라면 다른 갱신 방식이 더 적합합니다.

 

🍎 prepareForReuse()

prepareForReuse()는 UITableViewCell이나 UICollectionViewCell이 재사용되기 전에 자동으로 호출되는 메서드입니다.

 

공식 문서를 살펴보면…

“If a UITableViewCell object has a reuse identifier, the table view invokes this method just before the object is returned from dequeueReusableCell(withIdentifier:).”

— Apple Developer Documentation

 

재사용 큐에서 셀이 다시 꺼내지기 직전, 이전 데이터가 남아 있지 않도록 초기화하는 역할을 합니다.

 

prepareForReuse()의 내부 동작

1. 테이블뷰가 dequeueReusableCell(withIdentifier:)를 호출합니다.
2. 재사용 가능한 셀을 큐에서 가져옵니다.
3. 이 시점에 시스템이 자동으로 prepareForReuse()를 호출합니다.
4. 셀 내부의 상태(텍스트, 이미지 등)를 초기화할 수 있습니다.
5. 이후 cellForRowAt이 호출되어 새로운 데이터가 주입됩니다. 

 

사용 예시

커뮤니티 피드 앱에서 여러 게시글을 스크롤할 때, 스크롤이 빠를 경우 이전 게시글이 남아 보일 수 있습니다.

이때 prepareForReuse() 안에서 셀 상태를 초기화하면 문제를 방지할 수 있습니다.

class PostCell: UITableViewCell {
    @IBOutlet weak var usernameLabel: UILabel!
    @IBOutlet weak var contentLabel: UILabel!
    @IBOutlet weak var thumbnailImageView: UIImageView!

    override func prepareForReuse() {
        super.prepareForReuse()
        usernameLabel.text = nil
        contentLabel.text = nil
        thumbnailImageView.image = nil
    }
}

 

주의할 점

• 직접 호출하지 않아도 시스템이 자동으로 실행합니다.
• 항상 super.prepareForReuse()를 먼저 호출해야 합니다.
• prepareForReuse()는 초기화만 담당하며, 실제 데이터 세팅은 cellForRowAt에서 처리해야 합니다.
• 비동기 이미지 로딩이 있는 경우에는 이 시점에서 다운로드 취소나 상태 초기화를 수행해야 합니다.

 

🍎 reloadData() vs prepareForReuse() 비교

구분	reloadData()	prepareForReuse()
소속	UITableView / UICollectionView	UITableViewCell / UICollectionViewCell
호출 주체	개발자가 직접 호출	시스템이 자동 호출
호출 시점	데이터가 바뀌었을 때 (새 게시글 추가, 수정 등)	셀이 재사용되기 직전 (스크롤 중 화면 밖으로 나갔다가 다시 쓰일 때)
목적	화면 전체를 다시 그림 (데이터 반영)	셀 내부 상태 초기화 (이전 데이터 제거)
영향 범위	전체 리스트 (모든 셀)	해당 셀 한 개
호출 후 동작	numberOfRowsInSection → cellForRowAt 다시 호출됨	텍스트, 이미지 등 셀 속성 초기화
사용 예시	피드에 새 글이 추가되면 전체 새로고침	스크롤 시 이전 게시글의 이미지가 남지 않도록 초기화
직접 구현 필요 여부	직접 호출해야 함	메서드 자체는 자동 호출, 내부 초기화 코드는 직접 작성해야 함

 

🍎 beginUpdates() / endUpdates()

beginUpdates()와 endUpdates()는 나머지 세 메서드와 달리 UITableView 전용 메서드입니다.

여러 행(row)이나 섹션(section)의 변경 작업을 하나의 애니메이션으로 묶어 처리합니다.

 

beginUpdates() / endUpdates()의 내부 동작

1. beginUpdates()를 호출하면 테이블뷰가 업데이트를 시작합니다.
2. 그 안에서 삽입(insertRows), 삭제(deleteRows), 이동(moveRow) 등의 메서드를 호출합니다.
3. endUpdates()를 호출하면 테이블뷰가 내부적으로 변경 사항을 계산하고, 적절한 애니메이션을 적용합니다.

 

사용 예시

커뮤니티 피드에서 특정 게시글을 삭제하거나 추가하는 상황을 생각해볼까요?

var posts = ["UIKit 너무 재밌어용", "오늘 커피 두 잔째 ☕️", "iOS 18 업데이트 후기"]

func updateFeed() {
    posts.remove(at: 1)
    posts.append("새로운 피드 작성 완료!")

    tableView.beginUpdates()
    tableView.deleteRows(at: [IndexPath(row: 1, section: 0)], with: .fade)
    tableView.insertRows(at: [IndexPath(row: posts.count - 1, section: 0)], with: .automatic)
    tableView.endUpdates()
}

 

이런 상황에서 beginUpdates() / endUpdates()를 사용하면 한 번에 자연스러운 애니메이션으로 처리할 수 있습니다.

 

주의할 점

• beginUpdates() 호출 후 반드시 endUpdates()로 닫아야 합니다.
• 삭제 작업은 삽입보다 먼저 실행되어야 자연스럽습니다.
• 데이터소스 변경과 UI 업데이트 순서를 맞추지 않으면 크래시가 발생할 수 있습니다.
• 단일 변경이라면 insertRows 또는 deleteRows 단독 호출로 충분합니다.

 

🍎 performBatchUpdates(_:completion:)

performBatchUpdates(_:completion:)는 UITableView와 UICollectionView 모두에서 사용할 수 있는 일괄 업데이트 메서드입니다.

삽입, 삭제, 이동, 갱신을 한 번에 묶어서 처리하며, 작업 완료 시점을 completion 블록으로 받을 수 있습니다.

 

performBatchUpdates(_:completion:)의 내부 동작

1. 메서드를 호출하면, 컬렉션뷰가 내부적으로 여러 변경을 한꺼번에 처리할 준비를 합니다.
2. 클로저 안의 변경 작업이 모두 모아집니다.
3. 내부적으로 삭제 → 삽입 → 이동 → 갱신 순으로 정렬되어 실행됩니다.
4. 모든 애니메이션이 끝나면 completion 블록이 호출됩니다.

이 메서드는 특히 UICollectionView에서 복잡한 레이아웃 변경을 자연스럽게 표현할 때 유용하게 쓰입니다.

 

사용 예시

피드 화면에서 특정 게시글을 삭제하고 새로운 게시글을 동시에 추가한다고 가정해봅시다.

var posts = ["Swift", "Kotlin", "JavaScript"]

func updatePosts() {
    posts.remove(at: 1)
    posts.append("Python")

    collectionView.performBatchUpdates({
        collectionView.deleteItems(at: [IndexPath(item: 1, section: 0)])
        collectionView.insertItems(at: [IndexPath(item: posts.count - 1, section: 0)])
    }, completion: { finished in
        print("업데이트 완료 여부: \\(finished)")
    })
}

 

이 코드를 실행하면 삭제와 추가가 한 번의 자연스러운 애니메이션으로 처리됩니다.

그럼 사용자는 마치 피드가 실시간으로 갱신되는 것처럼 느끼게 되겠죠!

 

주의할 점

• 여러 변경을 한 번에 묶어 부드러운 애니메이션으로 처리합니다.
• 삭제는 삽입보다 먼저 실행됩니다.
• 호출 전에 레이아웃이 최신 상태인지 확인해야 합니다.
• (오래된 레이아웃이면 내부적으로 reloadData()가 발생해 애니메이션이 깨질 수 있습니다.)
• 안전한 호출 순서는 데이터 변경 → 인덱스 계산 → performBatchUpdates 호출입니다.