友元类声明必须在类内部，且被授权类需提前声明；友元关系单向，不继承。如class B;前置声明后，A中friend class B;允许B访问A的私有成员，但A不能访问B的私有成员。

友元类声明必须写在类内部，且需提前声明被授权类

友元类不是“互相友好”，而是单向授权：A 类声明 friend class B; 后，B 类的成员函数可以访问 A 的私有/保护成员，但 A 不能因此访问 B 的私有成员。常见错误是把 friend class B; 写在 A 类定义之外，或在 B 尚未声明时就引用它。

正确做法：

• B 类名必须在 A 类定义前已声明（可仅前置声明，无需完整定义）
• friend class B; 必须出现在 A 类体内部，通常放在私有区或公有区均可，位置不影响权限
• 友元关系不继承：若 C 继承 B，C 也不能自动访问 A 的私有成员

class B; // 前置声明

class A {
private:
    int secret = 42;
    friend class B; // ✅ 正确：B 被授权访问 A 的私有成员
};

class B {
public:
    void accessA(const A& a) {
        std::cout << a.secret << "\n"; // ✅ 可直接访问
    }
};

友元函数需在类内声明、在类外定义，声明时加 friend 关键字

友元函数不是类的成员，但它能访问该类所有私有/保护成员。关键点在于：类内只做声明（带 friend），不加作用域限定；定义必须在类外，且不能加 friend —— 加了会编译报错 "friend" declaration not in class scope。

容易出错的情形：

• 在类外定义时误写 friend void func(...); → 编译失败
• 忘记在类内声明，只在类外定义 → 函数无权访问私有成员
• 函数模板作友元时，未用 template 显式关联，导致实例化失败

class A {
private:
    double value = 3.14;
    friend void printSecret(const A& a); // ✅ 类内声明：带 friend，无实现
};

void printSecret(const A& a) { // ✅ 类外定义：不加 friend
    std::cout << a.value << "\n"; // ✅ 可访问
}

全局函数、类成员函数、重载操作符都可成为友元

友元不限于普通函数。你甚至可以把另一个类的某个成员函数设为友元（而非整个类），从而更精细地控制访问粒度。注意：被设为友元的成员函数所属类，必须在友元声明前完成前置声明或完整定义。

典型使用场景：

• 重载 输出操作符：让 operator 访问类私有字段输出调试信息
• 工厂类中某个创建函数需要读取目标类的私有构造参数
• 两个紧密协作的类，仅允许对方特定方法访问自身敏感状态

class A {
private:
    std::string data = "internal";
    friend std::ostream& operator<<(std::ostream& os, const A& a); // ✅ 友元操作符
};

std::ostream& operator<<(std::ostream& os, const A& a) {
    return os << "[A:" << a.data << "]"; // ✅ 直接访问私有 data
}

友元破坏封装性，但某些场景下不可替代

友元不是设计缺陷的遮羞布，而是为解决真实耦合需求提供的机制。比如标准库中 std::string 与 std::hash 的关系，或容器与其迭代器的协作，都依赖友元实现高效、安全的底层访问。

实际开发中要注意：

• 优先考虑组合、接口抽象或提供受控的公有访问函数（如 get_secret_for_test()）
• 一旦引入友元，该类与友元之间的编译依赖即增强：修改 A 的私有布局，可能迫使所有友元重新编译
• 单元测试中常借助友元函数访问私有逻辑，但应避免在生产代码中为测试而大量添加友元

最易被忽略的一点：友元声明不参与访问控制检查——即使写在 private: 区块里，它本身不是私有的，其他类仍能看到这个声明（只是无法调用）。这意味着友元关系是公开契约，不是隐藏实现细节。