“call to overloaded function is ambiguous”表示重载决议失败，因多个函数对实参具有相同优先级的转换路径，如char转int与double、float字面量转int/long、默认参数与重载混用等，需避免冗余重载并统一类型策略。
直接报错“call to overloaded function is ambiguous”，说明编译器在候选函数中找不到唯一最佳匹配。这不是语法错误，而是重载决议失败——你写的调用形式，恰好落在两个或多个函数的“可接受但优先级相同”的转换路径上。
为什么 print('A') 会歧义
字符字面量 'A' 是 char 类型，它既可被提升为 int（属于“提升匹配”），也可被标准转换为 double（比如 void print(double) 存在时）。这两条路径都属于第二级匹配，编译器无法判定哪个更优。
-
void print(int)和void print(double)同时存在 →print('A')必然歧义 -
void print(int)和void print(const char*)同时存在 →print("hello")没问题，但print(nullptr)或print(0)可能被当成空指针转const char*，与int版本冲突 - 哪怕只写
print(0)，若同时有void print(int)和void print(std::nullptr_t)，也会触发歧义
func(3.14) 匹配 int 还是 long？
当重载函数参数是整型家族（int、long、long long）而实参是浮点字面量时，double → int 和 double → long 都属于“标准转换”，优先级完全一致，编译器拒绝猜测。
- 避免同时提供
int和long重载，尤其当预期输入可能含浮点或字面量时 - 改用更明确的类型：比如只留
void func(long long)，再让调用方显式写func(3LL)或func(static_cast<long long>(3.14))</long> - 若必须支持多种整型，考虑用模板 +
std::enable_if限定，而非手动重载
默认参数和重载混用导致 func(5) 报错
比如同时定义了 void func(int) 和 void func(int, int = 0)，调用 func(5) 时，两个函数都完全匹配（第二个函数的默认参数不参与匹配判断），编译器无法取舍。
- 删除冗余重载：如果
func(int, int = 0)已覆盖单参数场景，就别再单独写func(int) - 把逻辑收归一处，用默认参数统一处理，而不是靠重载“模拟”默认行为
- 若需区分语义（比如“仅主键查询” vs “主键+条件查询”），改用标签参数：
func(int, std::integral_constant<bool true>)</bool>和func(int, std::integral_constant<bool false>)</bool>
真正棘手的不是报错本身，而是某些歧义只在特定平台或编译器版本下暴露——比如 size_t 在 32 位和 64 位系统上分别等价于 unsigned int 或 unsigned long，会导致同一段重载代码在一个环境编译通过，在另一个环境报歧义。写重载时，得把类型宽度和隐式转换链全盘想清楚，不能只看本地跑通。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
