因为 operator 是 C++ 中的关键字，用于定义重载操作符的函数，不能作为标识符（如变量名、函数名）直接使用，否则会导致编译错误。
为什么不能直接用 operator 成员函数？
因为 std::ostream 在左侧，自定义类型在右侧，而成员函数的隐式 this 指针永远是左操作数。写成 obj 不符合使用习惯，也违背标准流操作符的调用约定。
所以必须定义为非成员函数（通常是 friend），让 std::ostream& 作为第一个参数。
如何正确声明和定义 operator？
关键点：返回 std::ostream&，接受 std::ostream& 和 const T&，加 friend 声明（如果需访问私有成员）。
- 必须返回引用，支持链式调用（如
cout ） - 第二个参数强烈建议
const T&，避免无谓拷贝 - 若类有私有成员且需直接访问，把该函数声明为
friend；否则可定义在类外普通命名空间中
class Point {
public:
int x, y;
Point(int x = 0, int y = 0) : x(x), y(y) {}
// 声明为 friend，以便访问私有成员（本例中 x/y 是 public，仅为示意）
friend std::ostream& operator<<(std::ostream& os, const Point& p);
};
// 定义在类外
std::ostream& operator<<(std::ostream& os, const Point& p) {
return os << "(" << p.x << ", " << p.y << ")";
}
常见错误：忘记返回 os 或返回了值而非引用
典型症状：编译报错 “no match for ‘operator
立即学习“C++免费学习笔记（深入）”；
void operator → 编译失败，不满足流操作符签名std::ostream operator（返回值而非引用）→ 拷贝构造ostream，而std::ostream不可拷贝- 写了
os 但末尾漏掉return os;→ 返回未定义值，UB
涉及资源或格式控制时要注意什么？
如果自定义类型内部管理动态内存、文件句柄等，operator 本身不应释放资源；它只负责格式化输出。但若需临时修改流状态（如设置精度、填充字符），必须恢复原状，否则影响后续输出。
- 用
std::ios_base::iostate保存/恢复标志位（如os.flags(old_flags)） - 用
std::streamsize保存/恢复精度（os.precision(old_prec)） - 避免在重载中调用
os.clear()或os.setstate()等可能改变流错误状态的操作，除非你明确知道后果
流输出运算符本质是只读观察者，它的职责边界很窄：格式化、写入、返回引用。越界操作容易引发下游难以调试的流状态污染。
