C++带默认参数的loadScenePrebuilt函数调用出现重载匹配错误求助

问题场景 #

你声明的函数如下：

scene.h 文件：

Scene loadScenePrebuilt(SceneType type, const std::filesystem::path& dataDir, Config config = {});

scene.cpp 文件：

Scene loadScenePrebuilt(SceneType type, const std::filesystem::path& dataDir, Config config){
//random code
}

当不传入第三个参数config调用该函数时，触发错误：

C++ more than one instance of overloaded function matches the argument list:         
 one instance is 

Scene loadScenePrebuilt(SceneType type, const std::filesystem::path& dataDir, Config config = {})

and the other is 

Scene loadScenePrebuilt(SceneType type, const std::filesystem::path& dataDir, <error-type> config = <error>) 

错误原因 #

这是因为函数声明与定义的默认参数处理不一致，导致编译器误判存在两个重载函数：

• 头文件的声明中指定了默认参数Config config = {}
• 编译器在解析调用时，由于声明和定义的参数默认值设置逻辑冲突，误以为存在另一个参数类型异常的重载版本（错误信息里的<error-type>就是这种冲突导致的解析失败）

在C++规范中，默认参数应该只放在函数声明（通常是头文件）中，定义里不能重复指定。如果声明和定义的默认参数设置不一致，会让编译器在匹配调用时产生歧义，认为有多个符合条件的重载函数。

解决方法 #

修改scene.cpp中的函数定义，移除参数列表里的默认参数（默认参数已经在头文件声明中指定，定义只需保持参数类型和名称一致）：

Scene loadScenePrebuilt(SceneType type, const std::filesystem::path& dataDir, Config config){
//random code
}

同时需要确保：

• 代码中没有重复声明该函数的其他版本
• 头文件被正确包含，编译时声明与定义的参数列表完全匹配（仅声明带默认参数）

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