友元类声明必须在类内部,且被授权类需提前声明;友元关系单向,不继承。如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。
容易出错的情形:
立即学习“C++免费学习笔记(深入)”;
- 在类外定义时误写
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: 区块里,它本身不是私有的,其他类仍能看到这个声明(只是无法调用)。这意味着友元关系是公开契约,不是隐藏实现细节。











