[C++] C++ #include 헤더파일 순서

💡 본 문서는 'C++ #include 헤더파일 순서'에 대해 정리해놓은 글입니다.
C++ #include 헤더파일 순서 관련 문서를 찾아보다보니 구글의 가이드는 제가 이전에 하던 방식과는 정반대였습니다. 정답은 없지만 관련 내용에 대해 정리하였으니 참고하시기 바랍니다.

1. Google Styleguide

For example, the includes in google-awesome-project/src/foo/internal/fooserver.cc might look like this

#include "foo/server/fooserver.h"

#include <sys/types.h>
#include <unistd.h>

#include <string>
#include <vector>

#include "base/basictypes.h"
#include "foo/server/bar.h"
#include "third_party/absl/flags/flag.h"

2. Dependency

For example, fooserver.cc might look like this

#include "foo/server/fooserver.h"

#include "base/basictypes.h"
#include "foo/server/bar.h"
#include "third_party/absl/flags/flag.h"

#include <string>
#include <vector>

#include <sys/types.h>
#include <unistd.h>

마무리

위에 두 링크는 헤더 선언 순서 관련된 내용입니다. 헤더 순서를 정할 때 종속성을 완화하기 위해 스택 오버플로우 링크에서 제시한 방법을 보편적으로 사용하는 거 같습니다. 하지만 구글에서는 해당 파일의 헤더를 선언한 이후 위에서 언급한 방법과 정반대로 선언하게 됩니다. 구글 내부에서 프로젝트를 빌드할 때 순서가 다른건지 정확한 이유는 모르겠으나, 빌드의 종속성을 생각한다면 스텍오버플로우에서 언급한 후자가 맞을 것 같긴 합니다.

참고

• [StackOverFlow] C/C++ include header file order: https://stackoverflow.com/questions/2762568/c-c-include-header-file-order#:~:text=%22Thinking%20in%20C%2B%2B%22%20in%20particular%20mentions%20this%2C%20referencing%20Lakos%27%20%22Large%20Scale%20C%2B%2B%20Software%20Design%22
• [Google Styleguide] cppguide: https://google.github.io/styleguide/cppguide.html#Self_contained_Headers:~:text=Include%20headers%20in%20the%20following%20order%3A%20Related%20header%2C%20C%20system%20headers%2C%20C%2B%2B%20standard%20library%20headers%2C%20other%20libraries%27%20headers%2C%20your%20project%27s%20headers.