函数重载与默认参数混用会导致编译期二义性错误，因默认参数展开后多个重载版本签名冲突；默认参数只能出现在声明中，定义中重复将报错；应避免用默认参数破坏重载区分边界。
函数重载与默认参数混用时编译器会报二义性错误
当重载函数和默认参数同时存在，且调用方式恰好能匹配多个重载版本时，g++ 或 MSVC 会直接拒绝编译，报错类似 error: call of overloaded 'func(int, int)' is ambiguous。这不是运行时问题，而是编译期静态分析失败。
根本原因是：默认参数在调用前被“展开”成完整参数列表，再参与重载决议；如果展开后多个重载函数签名完全一致或可隐式转换到同一组类型，就无法唯一确定调用目标。
-
int add(int x, int y)和int add(int x, int y, int z = 0)同时存在时，add(1, 2)就是二义的——它既匹配无默认值的双参版本，也匹配三参版本（z取默认值） - 即使参数类型不同，比如
void f(double)和void f(int, int = 0)，调用f(1)仍可能冲突：1可转为double，也可作为第一个int参数触发默认值展开 - 避免在重载组中让任意两个函数经默认参数展开后，形参类型序列相同或可通过隐式转换互相抵达
默认参数必须全部写在函数声明里，且声明与定义不能都写
如果你把重载函数拆成声明（头文件）和定义（cpp 文件），默认参数只能出现在声明中；若定义里也写了，默认值不一致会导致链接失败或未定义行为，而一致则违反 C++ 标准——编译器会报错 default argument given twice。
- 正确做法：
header.h中写int func(int a, int b = 10);，impl.cpp中只写int func(int a, int b) { ... } - 错误写法：
header.h声明带默认值，impl.cpp定义时又写int func(int a, int b = 10) { ... }—— 编译不过 - 如果只有定义没有声明（如单文件 quick test），默认参数可以写在定义里，但一旦引入头文件机制，就必须统一到声明侧
重载函数的默认参数不能制造“参数数量相同但类型模糊”的局面
重载靠参数个数 + 类型组合区分；默认参数会悄悄改变“可见参数个数”，进而破坏原本清晰的区分边界。最典型的坑是：两个重载函数，一个少参+默认值，一个同参多类型，结果调用时谁都想接。
立即学习“C++免费学习笔记（深入）”；
- 例如：
void log(const char* msg)和void log(const std::string& msg, bool verbose = false)—— 调用log("hello")会失败，因为字符串字面量既可转const char*，也可构造临时std::string，再加verbose默认值，就触发二义 - 解决方案不是删默认值，而是让类型不可互转：比如把第二个改成
void log(std::string msg, bool verbose = false)（值传递），或显式禁用构造：explicit std::string(const char*)不可行，那就改名或加 tag 参数 - 更稳妥的做法是：对同一语义的操作，优先用单一函数 + 默认参数，而非用重载模拟；重载更适合处理本质不同的输入形态（如
intvsstd::vector<int>）
涉及 const、引用、模板时默认参数和重载交互更脆弱
默认参数值本身不能是局部变量，但若它是 const 全局量或 constexpr 表达式，再遇上重载中的 const T&、T&& 或模板推导，二义性会藏得更深，往往只在特定编译器或优化级别下暴露。
- 比如：
template<typename T> void process(T&& x)和void process(const std::string& s, int flags = 0)，传入字符串字面量时，转发引用版本可能被优先选中，而你本意是走带默认值的重载版 - 又如：
void handle(int x = 42)和void handle(long x)，调用handle()看似明确，但若int和long在当前平台等宽（如 LP64），某些老编译器可能认为两者转换代价相同，从而拒绝 - 这类问题很难靠肉眼排查，建议用
-Woverloaded-virtual（虽名不符实）或启用-Wambiguous-default-argument（Clang）提前预警
实际项目里，最常被忽略的是：重载决策发生在默认参数展开之后，而不是之前。这意味着你写的“看起来不会冲突”的重载，在加上默认参数后，可能已经悄悄变成一组等效签名。宁可多写一个函数名，也不要靠默认参数去“节省”重载分支。
