你在 Xcode 项目里只想试一小段 Swift，却不想先搭完整 App？
最快做法：在合适的 Swift 源文件中导入 Playgrounds，把短代码放进 #Playground，打开 Canvas 查看结果；它适合小段实验，不能替代完整 App 构建或课程验收。
适合正在学 Swift、想在现有项目里边写边运行代码的初学者。
如果你在区分 #Playground、独立 Playground 文件和 SwiftUI 预览，下面会说明各自用途。
如果课程指定 Xcode、而你手头没有 Mac，也可以据课程要求核对练习环境；仅看见 Canvas 结果不代表环境适用于完整作业。
最后更新于 2026 年 11 月 7 日，版本信息核实自 Apple 开发者发布记录、Xcode 更新文档及 Playground 宏使用文档。Apple 发布记录显示 Xcode 27.2 于 2026 年 10 月 29 日发布，而 Xcode 27.3 beta 于 2026 年 11 月 3 日发布；下文针对稳定版 27.2 的操作说明，不把 beta 行为当成已发布版本的保证。(developer.apple.com)
先选短任务，再判断 #Playground 是否合适
先拿一个能直接核对结果的小问题练习，例如计算几件物品的总价。你要验证的是“输入变化后，计算结果是否跟着变化”，而不是证明整个 App 能安装、启动或提交。
Apple 将 Playground 宏定位为在 Swift 文件中运行代码片段，并在 Canvas 显示结果；WWDC 演示也展示了在现有文件里加入片段、查看表达式结果，再修改代码观察更新。参照Apple 的 Playground 宏文档和WWDC 的 Xcode 26 演示，下面用最小计算示例说明流程。本文没有声称在本站实机运行过 Xcode 27.2；示例采用 Apple 文档说明的导入与宏写法，执行结果请以你打开的 Xcode 环境为准。
| 你要完成的事 | 建议方式 | 适用边界 |
|---|---|---|
| 在现有 Swift 源文件里试算、检查变量值 | #Playground 宏 |
快速实验，结果显示在 Canvas |
| 从空白开始做分章节的 Swift 学习练习 | 独立 Playground 文件 | 独立文档式练习，不是给现有源文件临时加片段 |
| 查看 SwiftUI 界面长什么样 | SwiftUI Preview | 展示和配置界面，不是一般 Swift 表达式练习 |
| 确认作业能否编译、运行或通过测试 | 项目构建、模拟器或课程指定测试 | 不能以 Canvas 有结果代替 |
独立 Playground 文件是单独创建的练习文档；Apple 的 Xcode 帮助介绍了创建与运行这类 Playground 的流程。#Playground 则可以写进项目已有的 Swift 文件中。SwiftUI Preview 面向界面预览，例如展示一个 View，而不是用来代替任意代码片段的实验区；具体区别可参考 Apple 的预览宏说明。
准备源文件：先保护项目，再选实验位置
打开现有项目后，在 Project navigator 里选一个 Swift 源文件。源文件可以理解为项目的“食谱页”：里面已有类型、函数或页面逻辑；Canvas 则是 Xcode 用来展示 Playground 或 Preview 结果的区域。Apple 的项目文件管理文档说明，Project navigator 可用于查看和管理项目中的文件。
初学者可以优先挑一个与实验相关、但不会误改课程核心逻辑的位置。若源文件包含复杂的初始化流程、私有依赖或大量界面代码，不要把整段文件复制进 Playground；先试一段独立、短小、能解释清楚的表达式。这样遇到错误时，你更容易判断是语法问题、项目依赖问题，还是代码本身的计算逻辑。
新增宏前先保存当前文件，必要时通过课程要求的版本管理方式留一份可回退记录。尤其不要为了试验而覆盖已有函数、删除原有代码，或把临时输入数据直接当成作业实现。
在现有项目里运行 Swift 片段
在源文件适合实验的位置加入 Playgrounds 导入和宏代码。Apple 的官方示例采用 import Playgrounds 与 #Playground { ... } 的组合；关于添加宏和运行结果，可查阅 Apple 的官方 Playground 宏文档。
import Playgrounds
#Playground {
let price = 12
let quantity = 3
let total = price * quantity
print(total)
}
price 和 quantity 是输入，total 是计算结果，print(total) 用来输出结果。你也可以把它改成自己的练习，比如计算分数平均值；但先保持变量和计算步骤简单，确认能解释每一行，再逐渐加入函数或条件判断。
操作上，先检查文件是否保存，再在 Xcode 中显示 Canvas。官方文档描述了通过 Canvas 查看代码片段结果的方式；如果编辑器顶部有多个 Playground 或 Preview 标签，可选择对应标签切换。Xcode 界面在不同版本或窗口布局下入口可能不同，优先参考Canvas 操作说明中的当前界面描述。
⚠️ Canvas 里出现
9，只说明这段练习代码运行并显示了结果；不能由此推断整个 App 已成功构建、模拟器能启动，或作业符合提交要求。
结果出现后做一次改动，再核对练习边界
先在 Canvas 看 total 的输出，再把 quantity 改成另一个值。运行更新后，检查结果是否按预期变化；如果结果未变，先确认改的是宏里的输入，而非文件中另一处同名变量。对于多段宏或同一文件里并存的界面预览，留意 Canvas 上方的标签名称，避免盯着旧的预览页。Apple 的文档说明，多项 Playground 与 Preview 可以通过 Canvas 标签切换。(developer.apple.com)
| 现象 | 先检查 | 怎么判断 |
|---|---|---|
| 没看到 Canvas | 通过编辑器视图选项打开 Canvas | 确认侧边结果区域确实显示 |
| Canvas 有区域但没结果 | 检查宏是否写在当前打开的 Swift 文件中，并确认选择了对应标签 | 避免看错文件或标签 |
| 结果仍是旧值或运行未完成 | 看工具栏运行状态；按界面提供的恢复或重新运行操作 | 等待执行结束后再判断 |
| 宏附近出现编译或语法提示 | 检查括号、花括号、导入，以及当前文件中的代码上下文 | 先处理编辑器指出的问题，再看运行结果 |
| 宏能显示结果，但作业仍要求构建 | 回到课程要求，执行完整构建、模拟器运行或指定测试 | Canvas 结果不能替代交付验收 |
表格是定位顺序，不是故障定论。Apple 文档说明 Canvas 可用于呈现 Playground 和 Preview 的结果，也提供显示、暂停或重新运行预览等操作；不同文件类型和界面状态可能影响你看到的入口。若你打开的不是源文件、选中了另一个标签，或者运行还没结束，先把这些操作环节核对完，再判断是否为版本或代码问题。参考编辑器窗口配置说明了解 Canvas 在编辑器中的位置。
验收边界：小片段、独立 Playground 与 SwiftUI 预览各司其职
长尾问题可以归结为一个区分：要在 Xcode 27.2 里运行一小段 Swift，就在现有 Swift 源文件中加入 #Playground 并通过 Canvas 看结果；要独立组织学习内容，则新建 Playground 文件；要看界面布局，则使用 SwiftUI Preview。三者都能辅助学习，但验证目标不同。
SwiftUI Preview 不能替代一般的 #Playground 代码练习：它主要展示并配置界面内容；反过来，宏结果也不能替代 Preview 对视图的检查。Apple 对 Preview 的说明明确指向在 Canvas 展示 SwiftUI、UIKit 或 AppKit 界面，对代码片段则另有 Playground 宏说明。
结束一次 Swift 代码练习前，按课程要求做下面的判断：
- ✅ 若任务只是理解变量、函数或表达式，并能说明代码用途、解释 Canvas 结果，就把这次实验记录下来。
- ↩️ 若课程要求新建独立练习文件、组织多个章节，或按指定方式提交代码，回到课程说明选择对应文件和提交流程。
- ⚠️ 若作业要求 App 构建、模拟器测试、运行单元测试或截图验收，就继续完成这些步骤；不要把 Canvas 显示结果写成“项目构建成功”。
- 🖥️ 若课程要求 Xcode、而你当前没有 Mac，先确认课程所需的 Xcode 版本、远程访问方式、文件传输和账户权限；不要预设远程环境一定支持你的具体操作。
你可以先阅读本站关于云端 Mac 环境对比的说明，按课程的实际要求判断是否适合远程使用。任何远程方案都应先核对版本、操作方式与权限，而不是只凭“能打开桌面”就当作完成了环境验收。
对只练短代码的学生，先用已有设备与当前可用工具，通常比为一次表达式练习立刻购置 Mac 更合适；但若课程确实要求 Xcode 构建，你当前的 Windows 环境会缺少课程指定的 macOS 开发条件，替代路线也可能带来额外的配置、访问和兼容性确认。此时可查看VpsHold 的云端 Mac 页面，先确认页面所列环境与访问、权限是否符合课程任务，再决定是否短期租用；如果你需要长期高频使用、依赖本地接口或稳定离线工作，自购 Mac 可能更合适。今天先拿课程里一段不涉及复杂依赖的 Swift 代码试跑，再按作业要求决定是否进入完整构建。