不同编译器对预编译头文件的处理

最近为了给xmake实现预编译头文件的支持,研究了下各大主流编译器处理预编译头的机制以及之间的一些差异。

现在的大部分c/c++编译器都是支持预编译头的,例如:gcc,clang,msvc等,用于优化c++代码的编译速度,毕竟c++的头文件如果包含了模板定义的话,编译速度是很慢的,
如果能够吧大部分通用的头文件放置在一个header.h中,在其他源码编译之前预先对其进行编译,之后的代码都能重用这部分预编译头,就可以极大程度上减少频繁的头文件冗余编译。

但是不同编译器对它的支持力度和处理方式,还是有很大差异的,并不是非常通用,在xmake中封装成统一的接口和使用方式,还是费了很大的功夫才搞定。

msvc的预编译头处理

预编译头在msvc的项目中很常见,经常会看到类似stdafx.cpp, stdafx.h的文件,就是用于此目的,而msvc编译器是通过编译stdafx.cpp来生成预编译头文件stdafx.pch的。

创建预编译头的命令行如下:

$ cl.exe -c -Yc -Fpstdafx.pch -Fostdafx.obj stdafx.cpp

其中,-Yc就是创建预编译头stdafx.pch的意思,通过-Fp来指定*.pch的输出文件路径,用-Fo指定编译stdafx.cpp生成对象文件。

其他源码是如何使用这个stdafx.pch的呢,通过将stdafx.h传入-Yu来告诉编译器,编译当前代码,忽略#include "stdafx.h",直接使用已经编译好的stdafx.pch文件。

$ cl.exe -c -Yustdafx.h -Fpstdafx.pch -Fotest.obj test.cpp

最后链接的时候,需要把:stdafx.obj, test.obj都连接上才行,这个也是和gcc, clang编译器不同的地方。

$ link.exe -out:test test.obj stdafx.obj

注:一定要吧stdafx.obj也链接上哦,虽然stdafx.cpp仅用于生成stdafx.pch,但是对象文件也是需要。

还有个跟gcc, clang有区别的地方是,msvc的-Yu指定stdafx.h必须是#include "stdafx.h"中的头文件名字,不是文件路径哦。

clang的预编译头文件处理

个人感觉clang的预编译头文件支持方式最为友好,也最为简单。

相比于msvc,不需要stdafx.cpp,只需要一个头文件stdafx.h就可以生成pch文件。
相比于gcc,可以灵活控制pch文件的路径,更加灵活。

编译头文件生成pch文件:

$ clang -c -o stdafx.pch stdafx.h

使用预编译头文件:

$ clang -c -include stdafx.h -include-pch stdafx.pch -o test.o test.cpp

其中-include stdafx.h用于忽略编译test.cpp中的#include "stdafx.h",通过-include-pch使用预先编译好的stdafx.pch

并且这里指定的stdafx.hstdafx.pch不仅可以是在includedir搜索路径下的文件,也可以指定全路径文件名,非常灵活,例如:

$ clang -c -include inc/stdafx.h -include-pch out/stdafx.pch -o test.o test.cpp

gcc的预编译头文件处理

gcc的预编译头处理方式基本上跟clang的类似,唯一的区别就是:它不支持-include-pch参数,因此不能所以指定使用的stdafx.pch文件路径。

它有自己的搜索规则:

  1. stdafx.h所在目录中,查找stdafx.h.pch文件是否存在
  2. -I的头文件搜索路径找查找stdafx.h.pch

编译头文件生成pch文件:

$ gcc -c -o stdafx.pch stdafx.h
top Created with Sketch.