因为 operator 是 C++ 中的关键字，用于定义重载操作符的函数，不能作为标识符（如变量名、函数名）直接使用，否则会导致编译错误。

为什么不能直接用 operator 成员函数？

因为 std::ostream 在左侧，自定义类型在右侧，而成员函数的隐式 this 指针永远是左操作数。写成 obj 不符合使用习惯，也违背标准流操作符的调用约定。

所以必须定义为非成员函数（通常是 friend），让 std::os

如何正确声明和定义 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

• 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() 等可能改变流错误状态的操作，除非你明确知道后果

流输出运算符本质是只读观察者，它的职责边界很窄：格式化、写入、返回引用。越界操作容易引发下游难以调试的流状态污染。