undefined reference to 'classname::classname()' 表明构造函数有声明但无定义：需检查是否在.cpp中实现且签名匹配；若为模板类，定义须在头文件；= default只能用于类内声明；避免odr违规和静态库符号裁剪。
构造函数声明了但链接时报 undefined reference to 'ClassName::ClassName()'
说明编译器看到了声明，但链接器找不到定义。C++ 要求：只要声明了构造函数（哪怕只有声明没写 = default），就必须提供定义，除非是纯虚类或显式删除（= delete）。常见于头文件里写了声明，却忘了在 .cpp 文件里实现，或者实现写在了错误的命名空间/类作用域内。
- 检查是否在对应
.cpp文件中实现了该构造函数，且类名、参数列表、const 限定符完全匹配声明 - 若构造函数在头文件中声明为
inline或定义在类体内（如class A { A() {} };），则无需单独实现 —— 但此时不能在.cpp中再写一遍定义，否则重复定义 - 若使用了模板类，构造函数定义必须在头文件中（或显式实例化），否则模板未实例化，链接时自然找不到
- 确认没有拼错类名或构造函数名（比如误写成
Classname或ClassName::ClassName(int)却只声明了无参版本）
用了 = default 还报链接错误？
= default 是定义，不是声明 —— 它告诉编译器生成默认实现。但它有使用限制：只能用于类内部声明时，且必须在首次声明时指定（不能先声明再 = default 补充）。如果写成了类外定义形式，比如：
class X { X(); };<br>X::X() = default; // ❌ 错误：类外不能用 = default
这会导致编译失败或链接失败（取决于编译器版本和模式）。正确做法是：
- 在类内声明时直接写：
X() = default; - 或干脆不写声明，让编译器隐式生成（前提是没声明其他构造函数且满足条件）
- 若必须类外定义，默认构造函数只能写成空函数体：
X::X() {}，不能加= default
头文件包含顺序或 ODR 违反导致链接失败
多个翻译单元中，同一个类的构造函数定义不一致（比如一个地方写了带参数的初始化列表，另一个地方没写），会违反 One Definition Rule（ODR），链接器可能随机选一个，也可能报错。尤其在宏控制、条件编译或不同头文件重复包含时容易发生。
- 确保所有源文件看到的类定义完全一致（包括构造函数是否
noexcept、是否constexpr、是否有默认参数） - 避免在头文件中用宏开关控制构造函数是否存在（如
#ifdef USE_INIT X() : x(0) {} #endif），这极易引发 ODR - 用
static_assert验证关键构造函数是否存在：static_assert(std::is_default_constructible_v<myclass>, "MyClass must be default-constructible");</myclass>
静态库/动态库中构造函数未被引用导致被裁剪
在构建静态库（.a）时，如果某个类的构造函数只在库内部被调用，而主程序没直接 new/定义该类型对象，链接器可能因“未使用”而丢弃整个目标文件（尤其是启用 --gc-sections 或 -ffunction-sections -fdata-sections 时）。
- 确认主程序中确实存在对该类对象的直接构造（如
MyClass obj;或new MyClass），否则链接器看不到引用 - 对静态库，可加
-Wl,--whole-archive -lmylib -Wl,--no-whole-archive强制保留所有符号 - 检查是否误将构造函数实现放在了未参与链接的
.cpp文件中（比如忘记加入 Makefile / CMakeLists.txt）
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
