重载operator是C++中通过定义成员或非成员函数，使自定义类支持如+、[]、==等运算符的机制；需遵循不能创建新运算符、不改变优先级等规则。
重载 operator 必须是非成员函数
直接在类内部写 operator 成员函数会编译失败，因为 <code>cout 是 std::ostream 对象，左操作数是它，不是你的类。成员函数的隐式 this 指针永远是第一个参数，但这里需要第一个参数是 std::ostream&。
正确做法是声明为全局（或 friend）非成员函数：
class Person {
public:
std::string name;
int age;
Person(const std::string& n, int a) : name(n), age(a) {}
// 声明为 friend，方便访问私有成员（如果有的话）
friend std::ostream& operator<<(std::ostream& os, const Person& p);
};
// 定义在类外
std::ostream& operator<<(std::ostream& os, const Person& p) {
os << "{" << p.name << ", " << p.age << "}";
return os; // 必须返回 os，支持链式输出如 cout << a << b
}
为什么返回 std::ostream& 而不是 void
不返回引用会导致 cout 编译失败——中间结果变成临时 <code>std::ostream 对象，而临时对象不能绑定到非 const 引用（operator 第一个参数是 <code>std::ostream&）。
常见错误现象：error: cannot bind non-const lvalue reference to an rvalue
立即学习“C++免费学习笔记（深入）”；
- 返回
void：链式调用崩溃 - 返回
std::ostream（值）：同上，且效率低、破坏流状态 - 必须返回
std::ostream&，且是传入的那个os引用
处理 const 和格式控制（如 std::endl）
operator 的右操作数建议用 <code>const T&，避免拷贝；左操作数 std::ostream& 本身就不能是 const（流要被修改）。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
你写的重载函数不影响 std::endl、std::setw 等操纵符——它们会按顺序作用于同一个流对象：
Person p{"Alice", 30};
std::cout << p << " | " << std::hex << 255 << std::endl;
注意：std::cout 的格式标志（如进制、精度）会持续生效，你的重载函数里一般不该主动修改这些，除非业务强依赖（比如固定输出十六进制 ID），否则容易污染下游输出。
头文件里定义还是实现分离？
如果把定义（函数体）放在头文件里，要加 inline，否则多个 cpp 包含该头时会链接重复定义错误：
inline std::ostream& operator<<(std::ostream& os, const Person& p) {
os << "[" << p.name << ":" << p.age << "]";
return os;
}
更稳妥的做法是：头文件中只声明，源文件中定义；或者用 inline + 头文件单定义。
容易被忽略的一点：如果你的类在命名空间里（比如 namespace app），那重载函数也得在**相同命名空间**，否则 ADL（参数依赖查找）可能找不到它，导致调用失败。
