Xcode 27.2 #Playground로 Swift 코드 조각을 어떻게 실행할까? 2026 초보자 안내

Apple 개발자 릴리스 기록에는 Xcode 27.2가 공개 버전으로, Xcode 27.3은 베타로 표시되어 있습니다. 릴리스 기록에서 버전 상태를 확인할 수 있습니다. Xcode 27.2에서 짧은 Swift 코드를 시험하려면 기존 프로젝트의 소스 파일에 #Playground를 넣고 Canvas에서 결과를 확인하세요. 다만 이 기능은 전체 앱 빌드나 과제 제출 검증을 대신하지 않습니다.

이 글은 Swift를 막 배우며 코드 조각을 자주 실행해 보고 싶은 학생, 기존 프로젝트에서 실험하는 방법이 궁금한 Xcode 27.2 초보자에게 맞습니다.
수업이 Xcode를 요구하지만 쓸 수 있는 맥이 없는 학생이라면, 마지막에 실습 환경을 고를 때 확인할 조건도 살펴보세요.

최종 업데이트: 2026년 11월 7일. 버전 상태는 Apple 개발자 릴리스 기록, 사용 순서는 Playground 매크로 문서를 기준으로 확인했습니다.

먼저 고른 실습과 도구별 쓰임

#Playground는 짧은 코드를 실행해 결과를 확인하는 기능입니다. Apple 문서는 이 매크로로 Xcode에서 코드 조각을 실행하고 Canvas에 결과를 표시할 수 있다고 설명합니다. 변수 계산이나 함수의 반환값처럼, 입력을 바꿔 결과가 어떻게 달라지는지 보는 연습에 알맞습니다.

처음에는 새 앱을 만들기보다, 현재 프로젝트 안에서 독립적으로 확인할 수 있는 작은 문제를 고르세요. 예를 들어 수업에서 배운 곱셈을 변수로 표현해 보면, 문법을 익히는 데 집중하면서 앱 화면이나 버튼을 만들 필요가 없습니다.

Apple은 프로젝트 파일과 폴더를 관리하는 방법을 별도로 안내합니다. 프로젝트 안의 파일 관리 문서를 참고해, 실습 위치가 기존 소스 파일인지 독립 파일인지 먼저 확인하세요. SwiftUI Preview는 인터페이스 미리보기 기능이므로, 화면이 아닌 계산 결과를 보고 싶다면 #Playground가 더 직접적인 선택입니다. Preview 매크로 문서에서 두 기능의 쓰임을 구분할 수 있습니다.

독립 Playground 파일과 #Playground는 무엇이 다릅니까? 독립 파일은 앱 프로젝트와 별도로 연습 공간을 두는 방식입니다. #Playground는 Xcode 프로젝트의 소스 파일 안에서 코드 조각을 시험하는 방식입니다. 과제에서 특정 프로젝트 파일을 수정해야 한다면 매크로 방식이 편할 수 있지만, 제출 파일 형식은 수업 안내를 따르세요.

프로젝트를 열고 실험할 자리를 정하기

Xcode 프로젝트는 앱을 만드는 데 필요한 파일을 모아 둔 작업 공간이라고 생각하면 됩니다. 소스 파일은 코드가 적힌 문서이고, Canvas는 실행 결과나 미리보기를 확인하는 영역입니다. 편집기에서 코드를 바꾼 뒤 실행하고 결과를 확인하는 순서로 진행합니다.

기존 파일을 바로 바꾸기 부담스럽다면 먼저 파일을 복제하거나, 수업에서 지정한 실습 파일을 사용하세요. 특히 파일 상단의 앱 코드나 이미 작성된 함수 사이에 실험 코드를 무심코 넣으면, 이름이 겹치거나 기존 동작을 바꿀 수 있습니다. Xcode 편집기 창과 영역 표시 방식은 설정에 따라 달라질 수 있으므로 프로젝트 창 구성 안내를 참고해 현재 편집기와 Canvas를 구분하세요.

실험 코드를 제출용 파일에 남기기 전에는 수업 요구사항과 비교하세요. 결과가 Canvas에 보였다는 사실만으로 앱 전체가 빌드되거나 과제 검증을 통과했다고 판단할 수 없습니다.

Xcode 27.2에서 #Playground로 Swift 코드 조각 실행하기

기본 절차는 코드가 들어갈 위치를 정하고, 매크로 안에 작은 실험을 작성한 다음 결과를 확인하는 것입니다. Apple의 매크로 사용 안내는 Xcode에서 코드 조각을 실행하는 흐름을 설명합니다.

1. 수업 프로젝트를 Xcode에서 엽니다. 프로젝트를 여는 방법과 파일 목록이 보이는지 확인하세요.
2. 실험할 Swift 소스 파일을 선택합니다. 기존 코드의 함수 안이나 다른 코드 블록 안에 무리하게 끼워 넣지 말고, 매크로를 둘 수 있는 독립된 위치를 고릅니다.
3. 다음처럼 입력과 계산이 분명한 짧은 예제를 작성합니다.

#Playground {
    let hours = 2
    let pagesPerHour = 12
    hours * pagesPerHour
}

4. Xcode에서 매크로를 실행합니다. 실행 방법이나 Canvas 표시 상태가 문서와 다르면 Xcode 도움말의 코드 실행 안내를 확인하세요.
5. Canvas에 결과가 나타나는지 살펴봅니다. 이 예제에서는 두 변수의 값으로 계산한 결과가 24가 되어야 합니다. 값이 다르면 입력값과 곱셈식을 순서대로 확인하세요.

코드에서 let은 값을 담을 이름을 정하는 선언입니다. hours와 pagesPerHour가 각각 입력값이며, 마지막 줄은 두 값을 곱합니다. 먼저 한 변수를 3으로 바꾸고 결과가 36으로 바뀌는지 확인하면, 실행 결과가 코드와 연결되는 과정을 익힐 수 있습니다.

Canvas에서 결과를 읽고 범위를 확인하기

Canvas는 결과를 관찰하는 곳이지, 앱 전체가 정상 작동한다고 증명하는 도구는 아닙니다. Canvas와 상호작용하는 방법을 참고해 결과 영역을 열고, 현재 보이는 항목이 방금 실행한 실험인지 확인하세요. 여러 미리보기나 실행 결과가 표시된다면 필요한 항목을 선택해 비교합니다.

실행했는데 Canvas에 결과가 보이지 않으면 무엇을 확인해야 합니까? 먼저 소스 파일에 #Playground와 실행할 코드가 실제로 들어 있는지 확인하세요. 다음으로 Canvas가 열려 있는지, 실행이 끝났는지 살펴봅니다. 그래도 결과가 없다면 현재 파일을 프로젝트에서 어떤 방식으로 열었는지, 사용 중인 Xcode 버전에서 해당 동작을 지원하는지 Apple의 매크로 안내와 Xcode 도움말에서 확인하세요. 개별 증상을 곧바로 일반적인 오류라고 단정하지 마세요.

SwiftUI Preview로 코드 조각 연습을 대신할 수 있습니까? 화면을 만드는 SwiftUI 코드라면 Preview로 인터페이스를 확인할 수 있습니다. 하지만 일반 계산이나 함수 결과를 시험하려는 목적과는 다릅니다. 화면 결과가 필요한지, 코드의 값과 흐름을 확인하려는지에 따라 도구를 고르세요.

작은 실험에는 빠르다는 장점이 있지만, 프로젝트 설정이나 앱 대상 기기와 관련된 문제를 모두 검사하지는 않습니다. 기존 코드에 선언한 이름과 충돌할 수 있고, 수업이 요구하는 빌드나 시뮬레이터 실행도 대신하지 않습니다. 따라서 연습이 끝나면 결과뿐 아니라 코드가 무엇을 계산하는지 설명할 수 있는지도 확인하세요.

과제에 연결할 환경을 조건에 맞게 선택하기

아래 조건으로 다음 행동을 정하면, 짧은 실습과 과제 검증을 혼동하지 않을 수 있습니다.

• 짧은 계산이나 함수 동작만 익히면 된다면 #Playground로 입력을 바꿔 가며 결과를 확인합니다.
• 수업이 독립 Playground 파일을 요구한다면 매크로를 대신 제출하지 말고, 안내된 파일 형식으로 연습 내용을 옮깁니다.
• 앱 전체 빌드, 화면 동작, 시뮬레이터 확인이 필요하다면 프로젝트를 빌드하고 수업에서 요구한 실행 환경으로 별도 검증합니다.
• 수업이 Xcode를 요구하지만 현재 컴퓨터에서 쓸 수 없다면 사용 가능한 맥 환경의 Xcode 버전, 접속 방법, 계정 권한을 확인한 뒤 진행 여부를 정합니다.

Windows에서 Xcode 과제를 시작해도 됩니까? Swift 문법을 읽거나 다른 학습 환경에서 기초 연습을 시작할 수는 있습니다. 그러나 과제가 Xcode 프로젝트 편집과 빌드를 요구한다면, 제출 전에 해당 Xcode를 실행할 수 있는 맥 환경이 있는지 확인해야 합니다. 온라인 안내만 보고 원격 환경이 수업의 버전이나 권한 조건을 충족한다고 가정하지 마세요. 우선 맥 환경 선택 기준 비교를 읽고, 원격 접속이 필요한 경우 한국에서 이용할 수 있는 클라우드 맥 환경의 현재 제공 조건을 직접 확인하세요.

집에서 쓰는 Windows 컴퓨터만으로 진행하면 Xcode 설치나 학교 계정 권한에서 막힐 수 있고, 별도 학습 환경을 마련하면 과제 파일과 결과를 옮기는 과정이 추가됩니다. 원격 맥은 그런 경우 임시 실습 환경으로 고려할 수 있지만, 장기간 무거운 작업을 계속하거나 기기에 직접 연결해야 하는 과제라면 자기 맥이 더 알맞을 수 있습니다. 다음 단계로는 수업 코드 중 짧은 계산 하나를 직접 실행해 보세요. 과제가 전체 빌드까지 요구하고 쓸 수 있는 맥이 없다면, VpsHold의 환경 조건을 먼저 확인해 버전·접속·권한이 맞는 경우에만 이용을 검토하세요.