Swift PropertyWrapper初始化变量失败问题求助

我来帮你拆解这个问题——你遇到的错误其实是Swift属性包装器初始化流程和计算属性访问时机冲突导致的，咱们一步步分析：

问题重现 #

你定义了一个用于格式化手机号的属性包装器MSISDN，当直接声明并初始化变量时：

@MSISDN var msisdn: String = "69 (4615)-11-21"

触发了编译器错误：

error: closure captures '_msisdn' before it is declared
@MSISDN var ms: String = "69 (4615)-11-21"
                ^
msisdn.playground:71:17: note: captured value declared here
@MSISDN var msisdn: String = "69 (4615)-11-21"
                ^

但分两步初始化（先声明再赋值）却能正常工作：

@MSISDN var msisdn: String
msisdn = "69 (4615)-11-21"

根本原因 #

问题出在你的属性包装器的wrappedValue getter实现上：

public var wrappedValue: String {
    get { return fullMsisdn } // 返回计算后的格式化值
    set { _wrappedValue = newValue }
}

当你在声明时直接赋初始值，Swift的初始化流程会做以下几件事：

1. 创建MSISDN实例，调用init(wrappedValue:)传入初始字符串
2. 编译器自动生成一个名为_msisdn的存储属性，用来保存这个包装器实例
3. 关键：此时编译器会尝试访问wrappedValue的getter来完成属性的初始化绑定

而你的fullMsisdn计算属性依赖cleaned，cleaned又依赖_wrappedValue，这个链式访问会间接引用到尚未完全初始化的_msisdn变量——因为_msisdn的声明和初始化是同步进行的，此时它还未完成绑定，所以编译器抛出“捕获未声明变量”的错误。

而分两步初始化时：

• 第一步声明属性时，MSISDN实例会用空字符串初始化（因为你没有传初始值，编译器调用init(wrappedValue: "")）
• 第二步赋值时，_msisdn已经完全初始化完成，访问wrappedValue的setter和后续的计算属性不会有任何问题

解决方案 #

要解决这个问题，我们需要调整属性包装器的逻辑，避免在初始化阶段触发对未完成绑定变量的访问。最直接的方式是在初始化时就完成格式化计算，而不是延迟到getter调用时：

@propertyWrapper struct MSISDN {
    private var rawValue: String
    private var formattedValue: String
    
    public var wrappedValue: String {
        get { formattedValue }
        set {
            rawValue = newValue
            formattedValue = process(newValue)
        }
    }
    
    // 统一处理清洗和添加国家码的逻辑
    private func process(_ str: String) -> String {
        let cleaned = str.replacingOccurrences(of: "[ \\-()]", with: "", options: .regularExpression)
        guard cleaned.count == 10 && cleaned.starts(with: "69") else {
            return cleaned
        }
        return "+30\(cleaned)"
    }
    
    init(wrappedValue: String) {
        self.rawValue = wrappedValue
        // 初始化时就完成格式化，避免getter阶段的延迟计算
        self.formattedValue = process(wrappedValue)
    }
}

修改后，直接声明初始化的方式就能正常工作了：

@MSISDN var msisdn: String = "69 (4615)-11-21"
print(msisdn) // 输出 "+306946151121"

另一种可选方案是将格式化后的结果放到projectedValue中，让wrappedValue直接返回原始值，这样也能避免初始化时的冲突，但这会改变属性的使用方式，需要根据你的业务需求选择。

内容的提问来源于stack exchange，提问作者Victor Benetatos