インクルードpathの入れ方，コマンド内部 or ファイル?

Question

#実際の現場ではインクルード文をどのように挿入するのでしょうか

江添さんの本を読んでいるのですが

#include <hoge.h>
...

と書くのではなくて，必要なヘッダをall.hに入れ，ソース内部ではインクルード文を書かずに

g++-11 -std=c++17 -Wall --pedantic-errors -include all.h main.cpp -o program

のような書き方をしています．
下のような書き方では何を用いるのかわかりづらくなるような気がするのに加え，エディタの推論が効かず非常に不便な気がしています．
私的にはヘッダファイルに入れるのは賛成で，コマンドに入れるのは反対なのですが，実際の現場でも下のような書き方をするのでしょうか？
その場合なぜなのでしょうか？

Answer 1

原則としては前者で書くのが好ましいと考えられる場面が多いです。

書籍では短いコード例をたくさん載せることになりますから、いちいち関連するヘッダをインクルードするのを書くとそれだけで結構な誌面を占めてしまうのでわずらわしく、説明上の便宜のために後者の書きかたをしているのだと思います。

その他、プリコンパイル済みヘッダを利用するときは後者に似た書き方になる場合もあると思います。

Comments

[eup]

ありがとうございます．
「プリコンパイル済みヘッダを利用するときは後者に似た書き方になる場合」というのはどういう場合でしょうか？
(#includeでもプリコンパイル済みヘッダを先に検索するような気がしますが後者の書き方によって得られるメリットはどのようなものがあるのでしょうか？)

Answer 2

後者のメリットとして考えられるのは、「ソースを書き換えることなく、インクルードするファイルを差し替えられる」と言うことくらいだと思うので、それが必要となるケースでは有効なのでしょう。

ただ、コンパイルオプションの-Dxxxxで#ifdef xxxxで分岐する方が良いケースが多いのではと思いますが。