依赖原则

1. 禁止循环依赖
2. 层级调用：下层模块不能包含上层模块

单例与线程安全规范

1. 禁止内部自调用：模块内部实现中，严禁调用自身的静态获取实例方法

Pimpl 惯习与头文件隔离

在头文件（.h）中，尽量不要 #include 具体的类实现，而是使用前向声明。

// Logger.h
class Config; // ✅ 前向声明：告诉编译器有个叫 Config 的类，但不知道它长啥样

class Logger {
    Config* m_config; // ✅ 指针/引用可以用前向声明
    // Config m_config; // ❌ 错误：编译器需要知道 Config 的大小
};

核心原则：访问控制隔离锁的使用

方法内部定义锁，同时调用另一个加锁方法会造成冲突，且无法追踪加锁状态。