Swift同名重载函数调用默认匹配错误版本的原因咨询

我定义了两个同名的static函数foo：

• 一个带有可选的completion block参数three，无返回值，同时包含可选参数one、two
• 另一个无three参数，返回State类型，同样包含可选参数one、two

当调用foo(one: "value")时，编译器默认匹配了有返回值的第二个函数，但我希望只有在接收返回值（比如let x = foo(one: "value")）时才匹配这个函数，请问这是什么原因？

这是由Swift的函数重载解析规则决定的，核心逻辑如下：

1. 返回值不参与重载决议
   Swift的重载筛选完全不考虑返回值类型，也不会根据你是否接收返回值来选择函数。不管是直接调用foo(one: "value")还是用变量接收返回值，编译器只依据传入的参数、参数标签、参数类型来筛选候选函数，返回值相关行为不会影响重载选择。

2. 参数匹配度优先级更高
   编译器会优先选择参数列表与调用场景匹配度更高的函数。第二个函数没有three参数，当你只传one时，传入的参数数量和第二个函数的参数列表（仅one、two，两者均为可选，调用时可只传一个）完全匹配；而第一个函数的参数列表包含one、two、three三个参数（哪怕three是可选，它依然是函数签名的一部分），因此编译器判定第二个函数的匹配度更高，会优先选择它。

3. 可选参数属于函数签名的组成部分
   带默认值或可选类型的参数不会被编译器自动忽略，它们是函数签名的固定组成部分。第一个函数的three是可选参数，但它仍然占据一个参数位，所以在参数数量匹配上，第二个函数更贴合只传one的调用场景。

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