Boost下载安装编译配置使用指南

理论上，本文适用于boost的各个版本，尤其是最新版本1.39.0；适用于各种C++编译器，如VC6.0，VS2003，VS2005，VS2008，gcc，C++ Builder等。

　　一、下载

　　首先从boost官方主页http://www.boost.org下载最新版boost安装包（目前最新版是1.39.0）。因为boost一部分类是需要编译成库才能使用的，所以我们还需要准备好boost专用的编译辅助工具bjam。网上很多人都提倡直接使用boost安装包中附带的bjam源码来编译出bjam，但是之前需要修改若干配置脚本才能编译成功。个人认为真没什么必要，费这劲毫无意义。boost官方网站在提供boost安装包下载链接的同时也提供与该版本安装包对应的bjam的下载，只有200多KB，可以一同下载下来。

　　二、安装

　　将boost安装包解压至本地目录，如：E:SDKboost_1_39_0，然后将bjam.exe拷贝到该目录下（bjam必须与boost-build.jam在同级目录）。

　　三、编译

　　接下来就是最重要的编译步骤了。需要打开命令提示符（cmd.exe）窗口并执行bjam，可以使用--help参数来查看命令帮助。这里详细讲解一下bjam的命令行参数，因为它非常重要。首先，它涉及到编程环境的搭建，你需要根据自己今后具体的使用环境来选择合适的命令行参数；其次，它影响到你的硬盘空间，完全编译的话据说在3G以上，如果你同时拥有2个以上的IDE（如VC6和VC9共存）而且都要用到boost，那么占用多少硬盘就自己算吧……虽说如今大家的硬盘空间都不成问题，但就像本人一样崇尚合理利用资源不习惯铺张浪费提倡节俭的童子应该大有人在。综合以上两点因素，本人使用的bjam命令如下：

bjam stage --toolset=msvc-9.0 --without-python --stagedir="E:\boost_1_39_0_vc9" link=shared runtime-link=shared threading=multi debug release

 

 

下面详细解释一下每个参数的含义，请务必仔细看完：

　　stage/install：stage表示只生成库（dll和lib），install还会生成包含头文件的include目录。本人推荐使用stage，因为install生成的这个include目录实际就是boost安装包解压缩后的boost目录（E:SDKboost_1_39_0boost，只比include目录多几个非hpp文件，都很小），所以可以直接使用，而且不同的IDE都可以使用同一套头文件，这样既节省编译时间，也节省硬盘空间。

　　toolset：指定编译器，可选的如borland、gcc、msvc（VC6）、msvc-9.0（VS2008）等。

　　without/with：选择不编译/编译哪些库。本人不需要编译python库，所以排除之，可以根据各人需要选择，默认是全部编译。但是需要注意，如果选择编译python的话，是需要python语言支持的，应该到python官方主页http://www.python.org下载安装。

　　stagedir/prefix：stage时使用stagedir，install时使用prefix，表示编译生成文件的路径。推荐给不同的IDE指定不同的目录，如VS2008对应的是E:SDKboost_1_39_0vc9lib，VC6对应的是E:SDKboost_1_39_0vc6lib，否则都生成到一个目录下面，难以管理。如果使用了install参数，那么还将生成头文件目录，vc9对应的就是E:SDKboost_1_39_0vc9includeboost-1_39boost,vc6类似（光这路径都这样累赘，还是使用stage好）。

　　build-dir：编译生成的中间文件的路径。这个本人这里没用到，默认就在根目录（E:SDKboost_1_39_0）下，目录名为bin.v2，等编译完成后可将这个目录全部删除（没用了），所以不需要去设置。

　　link：生成动态链接库/静态链接库。生成动态链接库需使用shared方式，生成静态链接库需使用static方式。这里需要注意的是，static方式下，最终生成的很多静态链接库大小都在几兆、几十兆，甚至接近百兆。这么大的库我们一般是不会采用静态链接方式的，所以这些库不推荐以static方式编译（without掉）；如果已经编译了赶快删，肯定没用，否则将占用近1G的硬盘空间。以下是巨型库黑名单：wave、graph、math、regex、test、program_options、serialization、signals。

 

 

runtime-link：动态/静态链接C/C++运行时库。同样有shared和static两种方式，这样runtime-link和link一共可以产生4种组合方式。虽然它和link属性没有直接关系，但我们习惯上，一个工程如果用动态链接那么所有库都用动态链接，如果用静态链接那么所有库都用静态链接。所以这样其实只需要编译2种组合即可，即link=shared runtime-link=shared和link=static runtime-link=static。

　　threading：单/多线程编译。一般都写多线程程序，当然要指定multi方式了；如果需要编写单线程程序，那么还需要编译单线程库，可以使用single方式。

　　debug/release：编译debug/release版本。一般都是程序的debug版本对应库的debug版本，所以两个都编译。

　　本人按以上方式分别编译了静态链接和动态链接两个版本后，整个E:SDKboost_1_39_0目录（包括安装包解压缩文件和编译生成的库文件）只有250MB。事实上编译完成后安装包解压缩文件除了boost目录之外其他目录和文件已经可以删除了，这样还可以腾出150MB的空间来。不过我又研究了一下，其实libs这个目录也很有用，它提供了所有Boost类的使用范例，平时可以作为参考；另外doc目录是一个完整的boost使用帮助文档，当然最好也不要删了。这样剩下的几个目录和文件加起来也就十多兆，索性都给它们留一条生路吧。

　　呵呵，一个完整而又完美的boost目录就此诞生了。

　　如果图省事，不想了解这么多，那么有简单的方法，可以使用命令：

bjam --toolset=msvc-9.0 --build-type=complete

　　直接指定编译器以完全模式编译即可，这样可以满足今后的一切使用场合，但同时带来的后果是：

　　1、占用3G以上的硬盘空间

　　2、占用若干小时的编译时间

 

 

3、头文件和库文件存放于C:Boost（个人非常反感）

　　4、生成的很多文件可以永远也用不上

　　四、配置

　　include目录：E:SDKboost_1_39_0

　　library目录：E:SDKboost_1_39_0vc9lib

　　添加到IDE相应的路径下面即可。

　　五、使用

　　使用举例：

#include <boostthread.hpp>

　　此时，不用包含库文件，boost的auto-link机制将会自动帮我们包含对应的静态lib。也就是说，boost默认是以静态方式链接的，这样我们的工程属性最好也设为Multi-threaded (Debug)。如果想使用dll动态方式链接，需要预先定义宏：

#define BOOST_ALL_DYN_LINK

　　同样，此时boost也会默认帮我们包含对应的lib。如果不想使用boost提供的auto-link机制，或者对它的自动链接不太放心的话（其实大可不必担心），可以预先定义宏：

#define BOOST_ALL_NO_LIB

　　然后使用以下方法链接：

#pragma comment(lib, "boost_thread-vc90-mt-1_39.lib")

　　或

#pragma comment(lib, "boost_thread-vc90-mt.lib")

　　这两个lib其实是一样的，实在不明白boost编译时为什么每个库都要复制一份，难道是因为后者在升级boost版本后不用改代码？另外还有一个比较有用的宏：

#define BOOST_LIB_DIAGNOSTIC

　　它可以让VC在编译时的output窗口中输出程序具体链接了哪些boost库以及链接顺序。

　　关于boost的auto-link机制，详细可以看看boostconfigauto_link.hpp里的代码，很容易可以读懂，并且值得我们学习。

 

 

注意一：

 link=static runtime-link=static

 link=static runtime-link=shared 可以是不同的组合

 

 

 

 

 

 

Boost库编译后命名方式

Boost官网的《Geting Started On Windows》（http://www.boost.org/doc/libs/1_38_0/more/getting_started/windows.html）提到了Boost库的命名，摘录如下：

 

以 libboost_regex-vc71-mt-d-1_34.lib 为例：

• lib
  前缀：除了Microsoft Windows之外，每一个Boost库的名字都以此字符串开始。在Windows上，只有普通的静态库使用lib前缀；导入库和DLL不使用。
• boost_regex
  库名称：所有boost库名文件以boost_开头。
• -vc71
  Toolset 标记：标识了构建该库所用的toolset和版本。
• -mt
  Threading 标记：标识构建该库启用了多线程支持。不支持多线程的库没有-mt。
• -d
  ABI标记：编码了影响库和其他编译代码交互的细节。对于每一种特性，向标记中添加一个字母：
  

  Key	Use this library when:
  s	静态链接到C++标准库和编译器运行时支撑库
  g	使用标准库和运行时支撑库的调试版本
  y	使用Python的特殊调试构建
  d	构建代码的调试版本
  p	使用STLPort标准库而不是编译器提供的默认库
  n	使用STLPort已被弃用的“native iostreams”

• -1_34
  版本标记：完整的Boost发布号，下划线代替点。例如，1.31.1版本将被标记为“-1_31_1”。
• .lib
  扩展名：取决于操作系统。在大多数unix平台上，.a是静态库，.so是共享库。在Windows上，.dll表示共享库，.lib是静态或导入库。

 

下表是对Regex库编译后的文件名：

文件名	含义	编译使用该库的程序时应使用的编译选项
libboost_regex-vc90-mt-sgd-1_38.lib	静态库，多线程，调试版本 使用静态调试版本C运行时库（LIBCMTD.LIB和LIBCPMTD.LIB）	/MTd
libboost_regex-vc90-mt-s-1_38.lib	静态库，多线程 使用静态版本C运行时库（LIBCMT.LIB和LIBCPMT.LIB）	/MT
libboost_regex-vc90-mt-gd-1_38.lib	静态库，多线程，调试版本 使用动态调试版本C运行时库（MSVCRTD.LIB和MSVCPRTD.LIB）	/MDd
libboost_regex-vc90-mt-1_38.lib	静态库，多线程 使用动态版本C运行时库（MSVCRT.LIB和MSVCPRT.LIB）	/MD
boost_regex-vc90-mt-gd-1_38.lib	导入库（boost_regex-vc90-mt-gd-1_38.dll），多线程，调试版本
boost_regex-vc90-mt-1_38.lib	导入库（boost_regex-vc90-mt-1_38.dll）多线程

 

需要注意的是，链接时，所使用的Regex库文件名必须和编译选项匹配，否则会造成如下链接错误：

LINK : warning LNK4098: defaultlib '×××××' conflicts with use of other libs; use /NODEFAULTLIB:library

原因是，当编译时，cl.exe（也就是VC的编译器）会根据上述编译选项在编译成的obj文件中植入相应的defaultlib文件名（使用DUMPBIN /DIRECTIVE ***,lib可以查看），如/MT对应的就是LIBCMT.LIB（C）和LIBCPMT.LIB（C++标准库）。当链接器处理该obj文件时，会从文件中取出该defaultlib文件名，将其放在命令行库列表的最后以供使用。对于静态库的处理也是如此，静态库也是由一些obj文件组成的，每个obj文件中也根据当时的编译选项被植入了相应的defaultlib。当链接器处理静态库时，也会将涉及到的obj文件中的defaultlib放在命令行库列表的最后。假设，我们的程序使用/MT编译，那个对应的defaultlib就是LIBCMT.LIB（C）和LIBCPMT.LIB（C++标准库）。而使用的是libboost_regex-vc90-mt-sgd-1_38.lib，它对应的defaultlib就是LIBCMTD.LIB和LIBCPMTD.LIB。链接过程中，链接器会发现采用了不同的运行时库，所以会出现上述错误。

 

幸运的是，Visual C++支持自动链接，当包含Regex的头文件时，Regex会根据当前工程的编译选项（不同的编译选项会定义不同的宏，具体参见上一篇C运行时库）自动告诉编译器将哪个文件送给链接器。