Xcode 27.2 #PlaygroundでSwiftコード片を実行する方法：2026年初心者向けチュートリアル

Xcode 27.2で短いSwiftコードを試すなら、既存のソースファイルに#Playgroundを加えて実行し、Canvasで結果を確認してください。小さな実験には便利ですが、アプリ全体のビルドや授業課題の提出確認の代わりにはなりません。

Swiftを学び始めた学生：短いコードを動かしながら覚えたい人に向いています。
Xcode 27.2を使う初心者：コード片、独立したPlaygroundファイル、SwiftUI Previewの違いを整理します。
Windowsを使っていて授業でXcodeが必要な人：実習に必要なMac環境や、課題の範囲を確かめたい人も対象です。

最終更新：2026年11月7日。Xcodeのバージョン状況はAppleのリリース記録、操作方法はPlaygroundマクロの公式ガイドを確認しています。

まず試すコード片を決める

最初は、変数を使った計算や短い関数など、結果を予想しやすい題材を選びましょう。たとえば、購入数と単価を掛けて合計を出すコードなら、入力を変えたときに結果がどう変わるかをすぐに確かめられます。

Appleは、#Playgroundマクロを使ってXcode内でコード片を実行し、Canvasに結果を表示する方法を案内しています。公式ガイドの使い方を見ながら、まずは既存プロジェクトのSwiftソースファイルで試してください。

「ソースファイル」はコードを保存する場所、「Canvas」は実行結果やプレビューを確認する領域です。コードを少し試す段階では便利ですが、アプリの画面や複数ファイルを含む動作まで確認できたことにはなりません。

Xcodeのバージョンは、執筆時点のAppleのリリース記録でXcode 27.2の公開とXcode 27.3のベータ版が確認できます。ベータ版は正式公開版とは扱いが異なるため、授業の指定バージョンに合わせてください。AppleのXcodeリリース記録で利用可能な版を確認できます。

既存ファイルと独立ファイルの使い分け

プロジェクト内で作業するときは、まず短い実験を置く場所を決めます。既存コードを消したり書き換えたりせず、実験用の部分を分けておけば、練習後に元の課題へ戻りやすくなります。ファイルの追加や整理についてはAppleのプロジェクトファイル管理ガイドも参考になります。

独立したPlaygroundファイルと、#Playgroundマクロはどう違いますか。
独立したPlaygroundファイルは、アプリのプロジェクトとは分けてコードを試したいときに使う形式です。一方、#Playgroundマクロは、既存のSwiftソースファイルの中で、特定のコード片を実行して結果を見る用途に向いています。どちらが使えるか迷ったら、「課題プロジェクトの中で試すならマクロ、独立した実験を続けるならPlaygroundファイル」と考えると選びやすくなります。

ソースコードにマクロを加えて実行する

プロジェクトを開いたら、まず対象のSwiftファイルを選びます。Xcodeのウインドウ構成やエディタの表示位置が見つからない場合は、プロジェクトウインドウの設定に関する説明を確認してください。

次に、試したいコードの周辺に#Playgroundを置き、波括弧の中へ実験用のコードを書きます。たとえば、次のような計算なら、最後に表示される合計が予想と合うか確認できます。

#Playground {
    let price = 120
    let quantity = 3
    let total = price * quantity
    print(total)
}

ここでのpriceは単価、quantityは個数、totalは計算結果を入れる変数です。コードを入力しただけでは実行結果を確認したことにならないため、実行を開始し、処理が終わってからCanvasを見ます。AppleのPlaygroundマクロの操作手順に沿って、マクロを追加する場所や実行方法を確認してください。

この例は計算の流れをつかむための短い練習です。授業のプロジェクトで実行するときは、既存コードを残し、実験部分が課題の動作や提出物に混ざらないかも確認してください。

Canvasで結果を見て変更を試す

実行後はCanvasを表示し、コードの結果が読み取れる状態か確認します。Canvasの開き方や操作は、AppleのCanvas操作ガイドを参照できます。複数のプレビューが表示される場合は、確認したい項目を選んでから結果を読みます。

次に、quantityの値を変えるなど、入力を一か所だけ変更して再実行します。結果も変われば、入力と計算の関係を確かめられます。変更した値と結果を説明できることを、短いSwiftコード練習の目安にしましょう。

SwiftUI Previewは、コード片の練習にも使えますか。
SwiftUI Previewは、SwiftUIで作った画面やインターフェースをCanvas上で確認するための仕組みです。一般的な計算や短い関数を試す目的なら、#Playgroundのほうが用途に合います。画面の見た目を確かめるならPreview、処理の小さな例を試すならマクロ、と分けてください。Previewの追加方法にも用途が説明されています。

表示されないときの確認点

実行したのにCanvasに結果が見えない場合は、何を確認しますか。
一度に設定を変えるのではなく、次の順に確認してください。

マクロが試したいコードを囲む形で追加されているか、公式のマクロ使用手順と見比べます。
Canvas自体が表示されているか、開き方を確認します。
実行が終わる前に結果を判断していないかを見直し、コードのエラー表示も確認します。
開いているファイルが、意図したプロジェクト内のSwiftソースファイルかを確かめます。
指定されたXcodeの版と、手元で使っている版が合っているかを確認します。版の状態はAppleのリリース記録で照合できます。

表示されない理由を、すぐにXcode全体の不具合と決めつけないことが大切です。マクロの位置、Canvasの表示、実行状態、ファイルの開き方を順に切り分ければ、どの段階で止まっているかを見分けやすくなります。

練習結果を課題の確認につなげる

短い実験が終わったら、コードが何をしているか説明できるか、入力を変えたときに結果がどう変わるかを確かめます。そのうえで、授業の指示に戻り、プロジェクト全体のビルドやシミュレーターでの動作確認が別途必要かを確認してください。Canvasに結果が出たことは、アプリ全体の構築や課題の提出条件を満たした証明ではありません。

条件に合わせて練習環境を選ぶ

次の項目にチェックを付け、当てはまる条件に合った方法を選んでください。

[ ] 短い処理の動きだけを知りたい：既存プロジェクトの#Playgroundで試します。
[ ] アプリ全体のビルドやシミュレーター確認が必要：課題プロジェクトに戻り、指定された手順で検証します。
[ ] Macがなく、授業でXcodeの操作が必要：利用する環境のXcodeの版、接続方法、操作権限を事前に確かめます。リモート環境がこのマクロに必ず対応すると決めつけず、実際に使う環境で確認してください。
[ ] 長期的に毎日使う、物理機器との接続が必要：レンタルより自分のMacを用意する方法も比較します。

Macが手元にない場合、今使っているPCだけでは授業指定のXcode環境を満たせないことがあり、学校端末ではインストール権限や利用時間にも制約があり得ます。さらに、コード片を試す環境と課題をビルドする環境が分かれていると、提出前に作業をやり直す可能性があります。授業がXcodeでの確認まで求めているなら、まずはMac環境の比較情報を読み、必要な作業範囲を整理してください。

自分のMacを買うほどではなく、課題期間だけXcodeを試したい場合は、VpsHoldの日本向けMac環境を確認する方法もあります。申込みを決める前に、利用できるXcodeの版、接続方法、権限が授業の条件に合うかを確認し、短いコード練習と課題のビルド確認を実際に分けて試してください。