SwiftUI .keyboardShortcut捕获Button动作值异常问题问询

问题现象 #

在 macOS 15.1、Xcode 16.1 Beta 环境下，使用.keyboardShortcut绑定SwiftUI Button时出现异常：

• 点击按钮时，状态变量能正常递增并打印最新值
• 按下快捷键触发时，首次执行正常，但后续触发始终打印初始值，状态更新后闭包仍捕获旧值

最小复现代码 #

import SwiftUI

struct ContentView: View {
    @State var number: Int? = 0
    
    var body: some View {
        if let number {
            Button("Test") {
                print("number: \(number)")
                self.number! += 1
            }
            .keyboardShortcut("w", modifiers: [])
        }
    }
}

原因分析 #

这是Xcode 16.1 Beta版本中SwiftUI的疑似Bug：

• 点击按钮时，Button会随View重建重新生成动作闭包，捕获最新的解包后变量值
• 快捷键触发时，可能复用了初始创建的闭包实例，导致闭包始终捕获第一次解包的number值（0），即使@State状态已经更新

临时解决方案（已验证） #

在Button动作闭包内重新解包self.number，避免依赖外层捕获的常量：

import SwiftUI

struct ContentView: View {
    @State var number: Int? = 0
    
    var body: some View {
        if let number {
            Button("Test") {
                if let number = self.number {
                    print("number: \(number)")
                    self.number! += 1
                }
            }
            .keyboardShortcut("w", modifiers: [])
        }
    }
}

优化方案（批量场景适用） #

针对大量带.keyboardShortcut的Button场景，推荐以下更高效的解决方式：

1. 提取动作到View方法中 #

将按钮动作逻辑抽成独立方法，方法内部直接访问最新的@State状态，避免闭包捕获问题：

import SwiftUI

struct ContentView: View {
    @State var number: Int? = 0
    
    var body: some View {
        if let number {
            Button("Test", action: handleButtonTap)
                .keyboardShortcut("w", modifiers: [])
        }
    }
    
    private func handleButtonTap() {
        guard let currentNumber = number else { return }
        print("number: \(currentNumber)")
        number = currentNumber + 1
    }
}

2. 将可选状态改为非可选（业务允许时） #

如果业务逻辑不需要number为nil，直接使用非可选的@State变量，彻底消除解包操作：

import SwiftUI

struct ContentView: View {
    @State var number = 0
    
    var body: some View {
        Button("Test") {
            print("number: \(number)")
            number += 1
        }
        .keyboardShortcut("w", modifiers: [])
    }
}

3. 使用ObservableObject管理状态 #

如果状态复杂，可将状态移到ObservableObject中，通过@ObservedObject或@StateObject引用，确保闭包能获取最新状态：

import SwiftUI

class ViewModel: ObservableObject {
    @Published var number: Int? = 0
}

struct ContentView: View {
    @StateObject private var viewModel = ViewModel()
    
    var body: some View {
        if let number = viewModel.number {
            Button("Test") {
                print("number: \(number)")
                viewModel.number = number + 1
            }
            .keyboardShortcut("w", modifiers: [])
        }
    }
}

总结 #

该问题大概率是Beta版本的SwiftUI Bug，建议关注Xcode正式版本的更新；当前可通过上述优化方案避免逐个闭包解包的繁琐操作，优先推荐将状态改为非可选（业务允许时）或提取动作方法的方案。

内容的提问来源于stack exchange，提问作者Jay Tang