在開發大C++工程的時候如何判斷和避免循環include?

3. include 頭文件使用絕對路徑，從VCS的根開始。

遇到這種情況基本上說明你的文件組織不好，通常我選擇的方法是把其中一個文件拆成兩個。因為你A-&>B的時候，B-&>A基本上只是為了A裡面的少數幾個類。這通常證明，AB裡面的那麼多類，按照現在的做法放在AB兩個文件，是不對的。於是你要重新思考一下文件的布局。你可以稍微調整一下。

本來關係密切的類，放在一起是應該的。

我回答完了。才發現題目是如何避免循環include頭文件，而不是如何避免重複include多餘頭文件。審題不清，不過回答還是保留著。

過度include不必要的頭文件，會增加編譯時間。對於C++來說特別嚴重。

頭文件中不能出現include, 所有必要的包含放到 cpp 文件裡面。

不過這方法用起來不方便。說一個簡單的，容易操作的。

比如寫類A，有文件 A.h, 和A.cpp

那麼在A.cpp中，將A.h的包含寫在第一位。在A.cpp中寫成

// 前面沒有別的頭文件包含
#include "A.h"
#include &
#include .......
.... 包含其它頭文件


之後可以嘗試在 A.h 中去掉多餘的頭文件。當A.cpp可以順利編譯通過的時候，A.h包含的頭文件就是過多或者剛剛好的。而不會是包含不夠的。

再來看如何減少A.h不必要的包含。

前置聲明

首先，只在頭文件中使用引用或者指針，而不是使用值的，可以前置聲明。而不是直接包含它的頭文件。

比如

class Test : public Base
{
public:
void funA(const A a);
void funB(const B* b);
void funC(const space::C c);

private:
D _d;
};


這裡，我牽涉到幾個其它類，Base, A, B, space::C（C 在命名空間space裡面）, D。Base和D需要知道值，A, B, space::C只是引用和指針。所以Base, C的頭文件需要包含。A, B，space::C只需要前置聲明。

#include "Base.h"
#include "D.h"

private:
D _d;
};


注意命名空間裡面的寫法。

對於C++裡面的智能指針，比如 std::shared_ptr&。這時候，A還是只需要前置聲明。而智能指針的頭文件需要包含。

簡單說來，就是類裡面包含實現類的指針。在cpp裡面實現。

從更大範圍的代碼組織上面來說。

提倡拆成多個小類。分散到多個文件。而不是全部塞在一個文件中。這點說起來簡單，現實中總會或多或少違反。

比如 工程需要用到一些常量字元串（或者消息定義，或者enum值，有多個變種）。一個看起來清晰的結構，是將字元串都放到同一個頭文件中，這樣就容易比較。不過這樣一來，這個字元串文件，就幾乎會被包含。當以後新加一個字元串時候，就算只加一行，工程幾乎被全部編譯。工程一大，夠看一章書了。以前我想偷懶的時候，就是這樣隨便改一改，跟著等編譯。

更好的做法，是按照字元串的用途來分拆開。

又比如，有些支持庫。有些不注意的，就會寫一個GlobalUtils.h之類的頭文件，包含所有支持庫，因為這樣可以不關心到底應該包含哪個，反正包含GlobalUtils.h就行，這樣多省事。不過這樣一來，需要加一個支持的函數，比如就只是角度轉弧度的小函數，也會發生連鎖編譯。

當寫個小函數只需要1分鐘，編譯需要30分鐘。我就寧願將小函數複製粘貼一次。這樣就容易引起代碼重複。

1. 要減少頭文件重複包含。需要團隊的人有這個意識，認識到這是不好的。我相信還是有很多人，對這問題認識不夠，你規定要這樣做，還會被當成小題大作。
2. 不要貪方便。直接包含一個大的頭文件，短期是很方便，長期會有麻煩。
3. 了解一些C++常用的手法。我相信很多人，連前置聲明，也是不知道的。

不是通常都ifdef或者pragma once嗎

1。保證每個頭文件都有#pragma_once或者#ifndef #define ... #endif （這是cpp的情況 oc可以略過）

2。在B類的.h頭文件裡面盡量只用class A;這樣先聲明一下A類 然後就可以在B的聲明裡面使用A類

3。在B類的實現文件裡面再#include"A.cpp"包含頭文件（cpp情況 如果是oc請務必使用import oc的import關鍵字能保證只包含一次 也即實現1中的功能）

4。對A類的頭文件和實現也是類似

為什麼相當一批回答（接近一半）不知道ifdef和pragma once?

哪怕是幾個文件的小工程也會遇到這種問題吧？難道不知道上面方法的人以往都是手工改代碼解決的循環問題？太可怕了。

這個問題真的很好，是面照妖鏡，一下子很多人就現了原形。

補充:是我理解錯了，沒看清問題的內容只看到了問題的標題。建議這個問題的標題需要修改。

不知道有沒有人是像我這樣處理的，網上似乎沒找到像我這樣的思路：

（我個人覺得挺好用的啊，為什麼沒人用呢。。。）

#pragma once
class A;//劃重點
#include"HeaderB.h"

class A{
B *b;
};


#pragma once
class B;//劃重點
#include "HeaderA.h"

class B {
A *a;
};


即：在類的頭文件中，額外在【#pragma once之下】、【需要用到該類頭文件之上】額外加一行該類的聲明。

常規處理class A和class B互相包含，是通過在class A的頭文件里加上class B的前置聲明。但是一旦class B改了個名字，就要去各個調用了class B的頭文件里到處找，然後一個個改名，非常麻煩。而這種方法相當於把class B的前置聲明統一交給class B自己的頭文件管理，想改名也只要直接右鍵重命名即可（指的是Visual Studio。。。）

如果【不想考慮/不想知道】哪些頭文件包含了自己這個類，只要直接把該類的前置聲明加在【#pragma once】下面即可。

或者養成習慣，每寫一個類的頭文件，都在【#pragma once】下面加一行自己的前置聲明，一勞永逸，麻麻再也不用擔心循環include。。。

附一張效果圖：

丑是丑了點但是好用啊。。。至於為什麼我把前置聲明插在一堆頭文件中間，是因為前面是UE4自帶的頭文件，肯定不會用到我自己寫的這個類啊。而下面是我自己寫的頭文件，才可能會用到我這個類。

正好用前置聲明隔開。。。

（其實我也不大確定這個是不是不規範的用法，因為網上真沒找到和我一樣這麼用的。。。。）

建議用cpplint檢查一下代碼規範，可以檢查include相關的規範的。

。。。。。。舊的慣例不是

#ifndef _FOO_H_
#define _FOO_H_
/* declarations go here */
#endif


這樣么？還有 #pragma once更方便，好像主流的編譯器也都支持了，到底是用了多小眾的編譯器才會不相容啊。