友元类声明必须写在被访问类的定义体内,且仅对该类生效;形式为friend class B;,支持前置声明,不继承、不传递,仅B的成员函数可访问A的私有/保护成员。

友元类声明必须写在类内部,且不能在类外补加
友元关系不是继承来的,也不是双向的,它只在声明它的那个类里生效。你不能在 A 类定义完之后,再在别处写一句 friend class B; 去“追加”友元关系——编译器根本不认。
常见错误现象:error: 'private_member' is private within this context,明明写了 friend class B; 还是报错,大概率是因为这行没放在 A 的类定义体内,或者放错了位置(比如放在了 public/private 区块之外但又不在类定义里)。
- 必须写在
A类的任意访问区块内(public、private、protected都可以,位置不影响权限) - 声明形式就是
friend class B;,不需要class B已经定义完成,前置声明足够 - 如果
B是模板类,要写成friend class B<t>;</t>或friend class B;(取决于是否需要泛化)
友元类能访问所有私有/保护成员,但不传递、不继承
被声明为友元的 B 类,其成员函数可以直接读写 A 的 private 和 protected 成员,包括字段和函数。但这权限仅限于 B 自己的成员函数,B 的友元、子类、甚至 B 的对象在全局函数里都不自动获得该权限。
使用场景:典型如容器类和迭代器类分离设计,vector 把 iterator 声明为友元,让迭代器能直接访问底层指针和 size;或两个紧密耦合的类(如 Node 和 Tree)中,Tree 需要自由修改 Node 的 left/right 指针。
立即学习“C++免费学习笔记(深入)”;
-
B的普通成员函数可直接访问A::private_member -
B的静态成员函数也行,只要它属于B类域 -
B的友元类(比如C)不能因此访问A的私有成员 - 性能无额外开销——友元只是编译期权限检查绕过,不生成任何运行时代码
友元函数 vs 友元类:别把全局函数误当友元类用
写 friend void foo(); 声明的是一个友元函数,不是友元类。如果本意是让整个 B 类获得权限,却漏写了 class 关键字,结果就是只有叫 foo 的那个函数有权限,B 其他成员依然被挡在外面。
容易踩的坑:IDE 自动补全有时会建议 friend B;(尤其在模板上下文中),但 C++ 语法要求必须是 friend class B; 或 friend struct B;;否则编译失败,报错类似 expected class-name before ';' token。
- 类友元:必须带
class/struct关键字,如friend class B; - 函数友元:不带关键字,如
friend void bar(A&); - 如果
B是struct,也要写friend struct B;,不能混用 - 命名空间内的类,要写全名,如
friend class ns::B;
跨文件定义友元类时,头文件依赖要理清
如果 A 在 A.h 里声明了 friend class B;,而 B 定义在 B.h 中,那么 A.h 必须能看到 B 的声明(至少是前置声明),否则编译器无法识别 B 是个类型。
但反过来,B.h 不需要包含 A.h —— 只要 B 的成员函数里不直接使用 A 的完整定义(比如不 new A、不调用 A 的内联函数),前置声明就够了。这点常被忽略,导致循环包含或编译变慢。
-
A.h顶部加class B;即可满足友元声明需求 - 若
B成员函数里要构造A对象或访问其内联函数,则B.cpp里才需#include "A.h" - 不要在
A.h里直接#include "B.h",除非真需要B的完整定义 - 用
#pragma once或卫士宏防止重复包含,但解决不了逻辑依赖混乱
B 用,别人也能照猫画虎写出另一个类去碰那些私有成员。











