Xcode 27 SwiftUI Preview가 표시되지 않을 때는? 2026 초보자 점검 순서

SwiftUI 미리 보기는 완성된 앱 그 자체가 아닙니다. Xcode가 어떤 화면을 보여줄지 알려 주는 미리 보기 정의가 있어야 캔버스에 결과가 나타납니다. 애플은 미리 보기 매크로가 SwiftUI 화면을 캔버스에 표시하는 방식을 설명하고 있습니다. 애플의 미리 보기 안내를 기준으로 다음처럼 구분합니다.

여기서 캔버스는 화면 옆에 펼치는 작업 초안입니다. 작업 대상은 이 화면을 어느 앱과 기기 조건으로 만들지 정하는 과제 대상에 가깝습니다. 처음부터 두 개를 같은 문제로 보면 점검 순서가 꼬입니다.

현재 파일이 SwiftUI 화면 파일인지 살펴봅니다. UIKit이나 AppKit 파일을 열어 놓고 SwiftUI 화면이 보이지 않는다고 판단하는 경우가 초보자에게 자주 생깁니다. 파일 아래쪽에 유효한 미리 보기 정의가 있는지도 확인합니다.

애플의 화면 파일에 미리 보기 추가 안내는 미리 보기 정의를 파일에 연결하는 방식을 설명합니다. 메뉴 이름이나 위치는 Xcode 27의 현재 설치 상태에 따라 다를 수 있으므로, 문서의 개념과 현재 화면을 함께 대조해야 합니다.

다음 항목을 순서대로 체크합니다.

• [ ] 열어 둔 파일이 SwiftUI 화면 파일입니다.
• [ ] 미리 보기 매크로 또는 호환되는 미리 보기 정의가 있습니다.
• [ ] 선택한 작업 대상의 플랫폼이 코드와 맞습니다.
• [ ] 화면을 다른 모듈이나 앱 대상에 잘못 연결하지 않았습니다.
• [ ] 파일을 저장한 뒤 다시 빌드했습니다.

미리 보기 정의가 없는 파일이라면 캔버스의 고장이 아닙니다. 보여 줄 화면을 지정하지 않은 상태입니다. 이 단계에서 파일과 작업 대상이 맞지 않으면 다음 단계로 가지 않습니다.

빨간색 오류가 있다면 먼저 코드 빌드 문제로 처리합니다. 미리 보기 창을 여러 번 새로 고치는 것보다 오류 목록에서 첫 번째 오류를 확인하는 편이 빠릅니다. 외부 패키지 누락, 이름 오타, 지원하지 않는 플랫폼 코드도 같은 범주에 들어갑니다.

반대로 프로젝트는 빌드되지만 미리 보기만 비어 있다면 고정된 데이터로 화면을 줄여 봅니다. 네트워크에서 받아오는 목록, 로그인 상태, 실제 기기 기능을 잠시 제거하고 글자 하나와 색상 하나만 남깁니다. 애플의 미리 보기 정의 참고 자료는 미리 보기 화면을 별도로 구성하는 기본 개념을 확인하는 데 도움이 됩니다.

미리 보기가 보인다고 앱 검수가 끝난 것은 아닙니다. 시뮬레이터와 실제 기기에서의 빌드, 권한, 실행 결과는 따로 확인해야 합니다. 미리 보기는 빠른 초안 확인이고, 최종 실행은 별도 시험입니다.

코드가 통과했다면 캔버스 표시 상태와 미리 보기 기기를 확인합니다. 캔버스가 꺼져 있거나 특정 외관과 기기 설정으로 고정되어 있을 수 있습니다. 캔버스 상호 작용 안내에는 기기와 설정을 바꾸며 미리 보기를 확인하는 방법이 정리되어 있습니다.

원격 맥에서는 화면이 잠시 멈춘 것과 Xcode가 컴파일 중인 것을 구분해야 합니다. 먼저 터미널에서 기본 명령이 실행되는지 봅니다. 그다음 Xcode의 빌드 표시를 확인합니다. 터미널은 반응하지만 화면만 늦다면 네트워크 표시 문제일 수 있습니다. 반대로 터미널도 반응하지 않으면 SwiftUI 코드보다 연결부터 확인해야 합니다.

• 파일에 미리 보기 매크로가 있고 빌드 오류가 없다면 캔버스 표시와 기기 설정을 계속 점검합니다.
• 최소 화면은 보이지만 실제 데이터 화면만 실패한다면 샘플 데이터와 초기화 코드를 나눠 수정합니다.
• 윈도우에서 문법과 파일 읽기만 하는 중이라면 그대로 학습합니다. Xcode 캔버스 검수만 필요할 때 환경을 바꿉니다.
• 학교 컴퓨터에 설치 권한이 없고 과제에서 실제 Xcode 결과가 필요하다면 호환되는 맥을 잠시 빌리거나 원격 맥을 선택합니다.
• 베타 운영체제나 Xcode 27 베타를 쓰는 중이라면 베타 상태를 먼저 기록합니다. 애플의 전체 출시 정보 목록에 게시된 현재 자료와 설치 상태가 다르면, 안정 버전의 일반적인 결과로 단정하지 않습니다.

Apple silicon 맥이 필요한지는 프로젝트의 요구 조건으로 판단합니다. 모든 Swift 문법 학습에 원격 맥이 필요한 것은 아닙니다. 캔버스 표시, Xcode 빌드, 맥 전용 기능 확인이 실제 과제에 포함될 때만 원격 환경의 가치가 생깁니다.

다음 화면은 인터넷, 외부 패키지, 로그인, 실제 기기 기능을 사용하지 않습니다. 기존 프로젝트가 복잡할수록 새 화면으로 환경을 먼저 검수하는 편이 안전합니다.

import SwiftUI

struct CheckScreen: View {
    var body: some View {
        Text("Preview 확인")
            .padding()
    }
}

#Preview {
    CheckScreen()
}

이 코드를 그대로 복사하는 것보다 다음 결과를 기록하는 것이 중요합니다.

• [ ] 새 SwiftUI 화면 파일을 만들었습니다.
• [ ] 미리 보기 정의가 화면에 연결되었습니다.
• [ ] 캔버스에 글자가 나타났습니다.
• [ ] 글자나 색상을 한 번 바꾸고 화면이 갱신되었습니다.
• [ ] 프로젝트 전체 빌드가 통과했습니다.
• [ ] 같은 결과를 시뮬레이터 또는 필요한 실행 기기에서 확인했습니다.

최소 화면도 표시되지 않으면 기존 앱의 데이터나 화면 구조를 계속 고치지 않습니다. 파일, 작업 대상, Xcode 설치 상태, 원격 연결을 다시 분리해서 봅니다. 최소 화면은 보이는데 기존 화면만 실패하면 환경보다 기존 코드와 데이터가 원인일 가능성이 높습니다.

위의 점검을 끝낸 뒤에도 판단이 서지 않는 경우가 있습니다. 아래 답변은 재설치나 환경 변경을 너무 빨리 선택하지 않도록 기준을 좁혀 줍니다.

캔버스와 시뮬레이터는 같은 것인가요?
아닙니다. 캔버스는 Xcode 안에서 화면 초안을 빠르게 보는 영역입니다. 시뮬레이터는 앱을 실행하는 별도 시험 기기입니다. 캔버스가 보인 뒤에도 앱 빌드와 실행을 따로 확인해야 합니다.

캔버스가 비어 있으면 반드시 Xcode를 다시 설치해야 하나요?
아닙니다. 먼저 파일 종류, 미리 보기 정의, 빨간색 빌드 오류, 작업 대상, 캔버스 표시 상태를 확인합니다. 이 항목을 통과한 뒤에도 최소 화면이 실패할 때만 설치나 시스템 문제를 의심합니다.

아이폰이 없어도 SwiftUI 공부를 계속할 수 있나요?
가능합니다. 문법, 화면 구성, 미리 보기와 프로젝트 빌드는 아이폰 없이 연습할 수 있습니다. 다만 알림, 카메라, 실제 기기 권한처럼 기기 기능이 필요한 과제는 별도 기기나 적합한 시험 환경이 필요합니다.

원격 맥은 장기 학습에 항상 적합한가요?
항상 그렇지는 않습니다. 짧은 과제, Xcode 전용 작업, 맥 구매 전 확인에는 유용할 수 있습니다. 매일 무거운 빌드나 물리 기기 연결이 필요하면 본인 맥이나 학교 장비가 더 맞을 수 있습니다. 연결 지연도 작업 조건에 포함해 판단해야 합니다.

베타 환경으로 정식 과제를 제출해도 되나요?
과제의 요구 버전과 담당자의 허용 범위를 먼저 확인해야 합니다. Xcode 27 베타 자료가 공식 문서에 있어도 베타의 동작을 모든 안정 버전의 보장으로 볼 수는 없습니다. 제출 전에는 사용한 Xcode와 운영체제 상태를 기록하고, 가능하면 요구된 환경에서 다시 빌드합니다.

윈도우나 학교 컴퓨터에서 계속 막히는 원인이 Xcode 전용 환경이라면, 현재 장비의 한계를 코드 오류로 오해하지 않는 것이 중요합니다. 로컬 장비는 설치 권한이 없고 맥 전용 도구를 실행할 수 없으며, 베타 환경은 과제와 맞지 않을 수 있습니다. 반면 원격 맥은 화면 지연과 연결 중단을 관리해야 하고, 물리 아이폰이 필요한 작업까지 대신해 주지는 않습니다. 짧은 SwiftUI 연습과 미리 보기 검수라면 MESHLAUNCH의 원격 맥 대여 조건을 확인한 뒤, 먼저 최소 화면이 과제에 충분한지 판단하는 편이 합리적입니다.

캔버스가 보이지 않을 때의 핵심은 재설치가 아니라 순서입니다. 미리 보기 정의, 빌드, 데이터, 캔버스, 연결 환경을 하나씩 분리하면 어디에서 막혔는지 기록할 수 있습니다. 로컬 맥이 없고 실제 Xcode 결과가 필요하다면 MESHLAUNCH의 맥 접속 안내를 확인하되, 최종 선택은 과제의 기기 요구와 사용 기간을 기준으로 결정하시기 바랍니다.