2. 开发环境搭建：Xcode 配置、Metal 项目创建、模拟器与真机调试

说实话，搭建环境是最枯燥但又最关键的环节。我在刚接触 Metal 时，光 Xcode 版本不对就折腾了小半天。你别小看这一步——后面所有调试、性能分析、真机运行都建立在它上面。咱们一步步来。

2.1 Xcode 版本与组件选择

Metal 是苹果自家框架，只能在 Xcode 里编译和调试。我个人习惯用最新稳定版 Xcode，因为 Metal 的特性更新基本跟着系统走。你至少需要 Xcode 14+ 才能支持 Metal 3 的完整功能。

安装 Xcode 时，务必勾选 Command Line Tools 和 iOS Simulator + macOS DriverKit。怎么确认？打开 Xcode → Preferences → Locations，看 Command Line Tools 那个下拉框有没有选对版本。

2.2 创建 Metal 项目（macOS + iOS 两种模板）

其实两种模板差别不大，但模板自带的样板代码能帮你省掉不少配置时间。我来分别说。

2.2.1 macOS 项目

1. Xcode → File → New → Project → macOS → App
2. Interface 选 SwiftUI / Storyboard 都行，Lifecycle 选 SwiftUI App Delegate
3. Language 选 Swift
4. 勾选 Use Metal（如果有）—— 其实勾不勾都行，我们后面手动加 Metal 依赖

项目创建后，打开 Build Phases → Link Binary With Libraries，点加号添加 Metal.framework 和 MetalKit.framework。这是必须的，模板不一定自动帮你加。

2.2.2 iOS 项目

1. File → New → Project → iOS → App
2. Interface 推荐 Storyboard（便于调试），Lifecycle 选 UIKit App Delegate
3. Language Swift，勾选 Include Tests（方便后续单元测试）
4. 同样手动添加 Metal.framework 和 MetalKit.framework

2.3 模拟器与真机调试环境

嗯，这里要注意：模拟器不是真机。Metal 在模拟器上使用宿主机的 GPU 或软件渲染，很多特性（比如 GPU 计数器、部分纹理格式）是不支持的。我之前在模拟器上调得好好的，一上真机画面撕裂——原来是模拟器对 MTLDrawablePresent 的同步要求宽松。

2.3.1 模拟器调试要点

• 检查 Metal 设备是否可用：MTLCreateSystemDefaultDevice() 返回 nil 说明不支持
• 模拟器上无法运行的特性：GPU 捕获、部分计算着色器调试、Metal Performance Shaders 中的某些滤波器
• 尽量用低分辨率来缓解模拟器卡顿

2.3.2 真机调试步骤

1. 连接 iPhone / iPad / Mac 到电脑，信任此电脑
2. Xcode → Window → Devices and Simulators，确认设备已识别
3. 选择真机 Scheme，点击运行（首次会弹 provisioning profile 提示，登录开发者账号自动处理）
4. 在真机上启动后，可以用 Xcode 的 Debug → GPU Frame Capture 抓帧分析

2.4 macOS 与 iOS 的 Metal 差异

同一套 Metal API，在 Mac 和 iPhone 上行为不一样。我整理了一份速查表。

说白了，你在 Mac 上写代码要时刻想着：“到了手机上，显存小了，纹理尺寸小了，某些 feature 直接没有。” 我就吃过亏：在 Mac 上用 MTLResourceStorageModeManaged 优化，结果跑 iPhone 上报错 —— iOS 只支持 Shared 模式。

2.5 一个完整的 Metal 初始化代码示例

下面是跨平台的 Metal 设备与视图初始化代码。注意我用 #if targetEnvironment(simulator) 做了模拟器特殊处理。

import MetalKit
import UIKit // or AppKit for macOS

class MetalViewController: UIViewController {

    var device: MTLDevice!
    var metalView: MTKView!

    override func viewDidLoad() {
        super.viewDidLoad()
        
        // 选择 GPU 设备
        guard let gpu = MTLCreateSystemDefaultDevice() else {
            fatalError("Metal 不可用")
        }
        device = gpu

        // 创建 MetalKit 视图
        metalView = MTKView(frame: view.bounds, device: device)
        metalView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
        view.addSubview(metalView)

        // 模拟器下关闭某些功能以避免崩溃
        #if targetEnvironment(simulator)
        metalView.framebufferOnly = true
        print("运行在模拟器，已设置 framebufferOnly")
        #else
        // 真机可用多采样抗锯齿
        metalView.sampleCount = 4
        #endif

        // 设置代理与清屏颜色
        metalView.delegate = self
        metalView.clearColor = MTLClearColor(red: 0.1, green: 0.1, blue: 0.2, alpha: 1.0)
    }
}

extension MetalViewController: MTKViewDelegate {
    func mtkView(_ view: MTKView, drawableSizeWillChange size: CGSize) {
        // 视图尺寸变化时重新计算投影矩阵等
    }

    func draw(in view: MTKView) {
        guard let commandQueue = device.makeCommandQueue(),
              let commandBuffer = commandQueue.makeCommandBuffer(),
              let renderPassDescriptor = view.currentRenderPassDescriptor else {
            return
        }

        let encoder = commandBuffer.makeRenderCommandEncoder(descriptor: renderPassDescriptor)
        // 绘制内容...
        encoder?.endEncoding()
        commandBuffer.present(view.currentDrawable!)
        commandBuffer.commit()
    }
}

你看，就这几行，已经覆盖了设备创建、视图设置、模拟器兼容、真机抗锯齿。我建议你把这个代码片段存成一个 Xcode 代码片段（右键 → Create Code Snippet），以后每建新项目直接拖出来用。

2.6 环境搭建的知识体系

下面这张图帮你串一下所有环节。从工具链到运行目标，再到调试手段，一目了然。