为何定义未使用的PromiseNamespace类型参数？此举是否有意义？

云上老周

2026-7-26

关于Swift中未使用无参数名PromiseNamespace参数的疑问

在如下Swift代码示例中，PromiseNamespace类型的参数无参数名且未被使用，请问为何要定义这类未被使用的参数，这样做是否具备实际意义？

func read<T>(_: PromiseNamespace,
             file: String = #file,
             function: String = #function,
             line: Int = #line,
             _ block: @escaping (SDSAnyReadTransaction) -> T) -> Promise<T> {
    return Promise { future in
        DispatchQueue.global().async {
            future.resolve(self.read(file: file, function: function, line: line, block: block))
        }
    }
}

这种写法主要有几个实际作用：

区分重载函数：这是最常见的场景。如果有另一个同名的read函数（比如不带PromiseNamespace参数的同步版本），这个无参名的参数能让编译器精准区分两个函数，避免重载冲突。调用时只需传入一个PromiseNamespace实例（通常是个空枚举，比如enum PromiseNamespace {}），就能匹配到这个异步Promise版本。
标记函数语义：这个参数相当于一个“用途标签”，一眼就能让开发者明白这是专门返回Promise的异步版本，和其他同名函数的定位不同，不用看函数体就能快速理解函数意图。
适配DSL风格调用：这类空类型参数常用来配合领域特定语言（DSL）设计，比如可以通过扩展PromiseNamespace实现链式调用，让代码写法更优雅，比如PromiseNamespace().read { ... }，比直接调用函数更符合异步代码的表达习惯。
预留扩展空间：当前没用到这个参数，但未来如果需要给该函数添加Promise相关的配置项，这个参数可以作为扩展点，无需修改函数签名就能升级功能，保持API的兼容性。