“no matching function”错误主因是函数签名不匹配而非未定义，包括参数类型、const限定、访问权限、模板推导失败等；链接时“undefined reference”则表明声明存在但定义缺失或未参与编译。
报错说“no matching function for call to …”但类里明明写了这个函数
这通常不是“没写”，而是函数签名对不上。编译器看到调用点，去类里找匹配的成员函数，结果发现参数类型、const 限定、引用/值传递方式或重载优先级都不吻合。
常见现象：undefined reference to 'MyClass::process(std::string)' 看似是链接错误，实则是编译期就因找不到匹配声明而没生成调用代码；或者报 error: no matching function 后跟一串 note: candidate function not viable，说明函数存在，但参数无法隐式转换或 const 不匹配。
- 检查调用时传的实参类型，比如传了
const char*却期望std::string&&，或传了int却期望size_t - 确认成员函数是否加了
const，而你在 const 对象上调用了非 const 版本 - 留意是否误把函数声明写在 private 区域，而调用发生在类外
- 如果是模板成员函数，确保它定义在头文件中，且实例化类型能推导成功（例如
process("hello")推导不出T）
编译通过但链接时报“undefined reference to MyClass::xxx”
说明声明有了，定义缺失或不可见。C++ 分声明和定义两步，类内声明的非内联成员函数必须在类外提供定义，且该定义得被编译进某个 .o 文件并参与链接。
典型场景：你在 myclass.h 里写了 void do_work();，但在 myclass.cpp 里忘了实现它；或者实现了，但编译命令漏掉了 myclass.cpp。
- 检查对应
.cpp文件是否存在该函数的完整定义，格式应为：void MyClass::do_work() { /* ... */ } - 确认构建系统（Makefile / CMake / IDE）确实把实现文件加入了编译列表，
g++ main.cpp myclass.cpp -o app缺一不可 - 如果是 static 成员函数，定义时不能漏掉
MyClass::作用域限定 - 内联函数（
inline或定义在类体内）必须保证所有调用点都能看到完整定义——所以一般放头文件里
模板类成员函数调用失败却没报错
这是最隐蔽的一类：“没报错”不等于“没问题”。模板函数只有被实际调用（或取地址）时才会实例化，未触发的代码根本不会编译，更不会暴露语法或语义错误。
比如你写了 template<typename t> void Vec<t>::unsafe_op() { int* p = nullptr; *p = 1; }</t></typename>，只要没人调 v.unsafe_op()，这段空指针写入就永远沉睡，直到某次发布后突然崩溃。
- 在头文件末尾加显式实例化语句，强制编译器检查：
template class Vec<int>;</int>、template class Vec<:string>;</:string> - CI 流程中加入“模板穷举编译”步骤，对项目中实际用到的模板类型逐个实例化
- 避免在模板函数里依赖仅对部分类型有效的接口（如
T::data()），改用if constexpr (has_data_v<t>)</t>或 SFINAE 约束 - 注意：显式实例化必须放在定义可见的位置（通常是头文件末尾），否则链接时报
undefined reference
类里有 const/static 成员却编译不过
const 成员变量若非常量表达式初始化，必须走构造函数初始化列表；static 成员变量则必须在类外单独定义——这两类错误常被误认为“类没写全”，其实是违反 C++ 初始化规则。
例如：class A { const int x; static int y; }; 若只在类内声明，不处理，编译直接失败。
-
const非静态成员：只能在构造函数初始化列表中赋值，不能在构造函数体里用=赋值 -
static数据成员：类内只是声明，必须在某个.cpp文件中定义一次，如int A::y = 0; -
static constexpr成员可在类内直接定义，但普通static const整型也允许类内初始化（C++11 起），其他类型仍需类外定义 - 忘记给
const成员写初始化列表，会触发member 'x' must be initialized by a mem-initializer类错误
容易被忽略的是：这些错误往往不在第一眼报错位置。比如模板实例化失败导致的 no matching function，实际根源可能在十层调用栈之外的某个辅助函数里用了不兼容的类型。盯住报错里第一个 note: in instantiation of member function 提示的调用点，顺藤摸瓜才最有效。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
