浅谈 Qt 静态编译

Qt 静态编译是本文要介绍的内容，首先，你应该该知道什么叫静态引用编译、什么叫动态引用编译。我这里只是简单的提提，具体的可以google一下。

动态引用编译，是指相关的库，以dll的形式引用库。动态编译的Exe程序尺寸比较小，因为相关的库都没有包含进来。当然，程序发布的时候，还要把相关的库也一并发布出去。

静态引用编译，是指把相关的库也一并引入Exe文件。这是程序的尺寸就会很大，不过，程序发布就会变得简单很多。

其次，你可能会注意到我标题上写了“真正”这两个字。为什么我要强调真正这两个字呢？因为使用VC编译的C或者C++程序，都需要相关的C runtime库才能运行。如果你是VC6，相应的库就叫MSVCR，如果是vc2005，那就是MSVCR08，vc2008就是MSVCR09。我这里假设你安装的是VC2005，请进入如下目录：${VS Install Dir}\VC\redist\x86 和 ${System Driver}:\windows\WinSxS，你就会发现下面有很多很多的库。没错，这里相当一部分就是C runtime库。

好了，言归正传，首先，我们用VC2005写了一个不使用MFC的存C或者C++的程序，怎么发布给最终用户呢？有两个方法：

（1）静态引用C runtime库：打开“项目”->“XXX属性”->“配置属性”->“C/C++”->“代码生成”->“运行时库”。看到了吧？这里一共有四个选项，其中MT开头的是静态引用，MD开头的是动态引用，d结尾的是Debug调试版本，没有d的是Release发布版本，所以就一共有四个选项。我们选择/MT，然后编译程序（生成的程序应该不小），把这个程序发给用户，然后用户就可以直接运行了。
（2）动态引用C runtime库：跟上面差不多，不过是用/MD选项编译（程序应该只是几十K），然后发给用户。这时，用户是不能运行这个程序的，会报个什么程序引导失败，重装系统可能会修复问题之类的提示。这是我们还要把C runtime库一并发过去。把${VS Install Dir}\VC\redist\x86\Microsoft.VC80.CRT下的所有文件（注意，是所有，包括那个.manifest文件）发给用户，用户把这些文件放在我们的程序的同一个目录，然后再次运行，这时，程序就起来了（VC2005之后，C runtime库的引用改变了很多，建议google一下）。

说完C runtime库，就来说说Qt库了，这里我假设你用的是最新的Qt4.4.3。我们编译Qt的时候，configure.exe有很多参数，大家可以configure.exe --help来看看，其中，默认生成的Qt库（这里默认的意思，是指没有加-share或者-static参数）是动态引用的，也就是说，编译完后，在QtDir的lib目录下除了一大堆lib文件外，还有一大堆的dll文件。我们发布我们的Exe程序的时候，需要把相应的Qt库的Dll也一并发给用户。

按照Qt的安装手册和网上一大堆大牛的说法，加上-static参数后，Qt就可以静态编译了，也就是说，lib目录下之后一大堆lib文件，没有dll文件。是否？我们做个试验：

首先是设置变量：

set QTDIR=%CD%
set PATH=%PATH%;%QTDIR%\bin
set QMAKESPEC=win32-msvc2005
"C:\Program Files\Microsoft Visual Studio 8\VC\vcvarsall.bat"" x86

配置makefile：

configure -release -static -fast -qt-sql-odbc -qt-sql-sqlite -no-webkit

（这里的参数就不一一说明了，建议读者打入--help认真查查，特别注明一下，之所以-no-webkit，是因为新版的qt加上了Webkit，而这个东东编译的时候非常耗时间，编译后也很大，有100多M，并且我基本不会用到这个东东，所以忽略它）

然后

cd src （我之所以直接进入src目录nmake，是因为不想make其它不相干的模块，节省时间）
nmake

漫长的等待之后，我们发现lib下果然只有一大堆lib文件了，而且每个lib文件的尺寸都在M以上，似乎已经成功了。然后我们在安装了qt-vsintegration的VC2005新建一个Qt工程，然后编译一个release版本。编译的时候，问题来了。我们选择/MD选项，这时链接就可以通过，但如果我们想要用/MT选项来使用静态C runtime库，就会报一大堆某某函数链接重复之类的错误。经验告诉我们，之所以不能使用/MT来编译，是因为另外一个库——Qt库使用了另外一种引用方式/MD（原则上来说，一个程序里面的所有模块，都应该使用同一种引用方式，具体可以google一下）。很显然，我们编译的所谓静态Qt程序，一样要背着微软的C Runtime库到处跑，还不够“真正”的静态。

怎么才能做成完全的静态呢？记得之前编译wxWidgets的时候，它除了有SHARED=0或者1的选项之外，还有一个RUNTIME_LIBS = static or dynamic的选项，很显然，这个RUNTIME_LIBS的选项就是我们想要的选项。不过我翻遍了Qt的安装手册以及网上大牛的文章，都没有提及这个问题，我当时心里就觉得奇怪，难道没人遇到过这个问题？我又认真翻查了configure.exe的help，也没有类似的选项，问题一下就僵住了。

回忆一下刚才我们编译的时候，屏幕上调用cl.exe编译的时候，有这样一个参数：cl.exe .... -MD .... xxx.cpp，眼利的朋友一下就会发现，这个-MD就是c runtime动态引用的选项。然而，怎么把这个-MD改成-MT呢？我们翻开刚才我们编译的qt的src目录下，随便找个目录进去，打开Makefile.Release，我们就会看到CFLAGS=-MD ........，没错，就是这里。我们只要在这里把-MD改成-MT，就会使用静态c runtime库编译Qt了。我们当然不可能一个一个地替换这些makefile，关键是找出生成这些参数的模板文件。很显然，它肯定在qt的mkspecs目录，我们直奔win32-msvc2005目录，果然找到一个qmake.conf文件，果然找到一个QMAKE_CFLAGS_RELEASE = -O2 -MD，把这里的-MD换成-MT，然后清理一下刚才的生成的配置信息（网上又说用nmake confclean来清空，不过我没有成功，貌似是使用了-fast参数的缘故，不过没关系，把这个目录删掉，重新解压一份源代码就可以了，然后把win32-msvc2005目录下的qmake.conf的-MD换成-MT），重新

configure -release -static -fast -qt-sql-odbc -qt-sql-sqlite -no-webkit

然后nmake

又是漫长的等待。不过我们不要干等，看看出来的编译命令，cl.exe .... -MT .... xxx.cpp，果然变成静态c运行库了。

编译完之后，像刚才那样，在VC2005建一个Qt的工程，然后用/MT这个选项编译，OK，编译成功，出来的Exe文件大小是4.95M，貌似已经把C runtime库嵌进来了。然后把这个程序放到用户那里运行，OK单个Exe文件运行成功了。

至此，编译真正静态的Qt程序试验完成。总结一下整个过程，首先是要有耐性，因为编译一次Qt都至少两个小时（当然，用一些技巧，例如-fast，-no-qmake，只编译src等等的技巧可以缩短很多时间），我来回就编译了五次Qt；其次熟悉一些常见的编译、链接的错误，例如一见到XXX库已经引用之类的错误，马上就联想到应该是引用不同的库导致的；最后，要善于发现问题，查找问题。