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

<h1 class="postTitle">
<a id="ctl04_TitleUrl" class="postTitle2" href="http://www.cnblogs.com/wondering/archive/2009/05/21/boost_setup.html">Boost下载安装编译配置使用指南（含Windows和Linux）</a>
</h1>
<div class="postBody">
<div id="cnblogs_post_body">

<p>理论上，本文适用于boost的各个版本，尤其是最新版本1.45.0；适用于各种C++编译器，如VC6.0（部分库不支持），VS2003，VS2005，VS2008，gcc，C++ Builder等。先总结一下Windows系统。</p>
<p><span style="font-size: small;"><strong><span style="color: #666699;">一、下载</span>
</strong>
</span>
</p>
<p>首先从boost官方主页<span style="color: #000000;"><span style="text-decoration: none;"><a title="http://www.boost.org" href="http://www.boost.org/" target="_blank">http://www.boost.org/</a>
下载最新版boost安装包（目前最新版是boost_1_45_0.7z）。</span>
</span>
</p>
<p><span style="font-size: small;"><span style="color: #666699;"><strong>二、安装</strong>
</span>
</span>
</p>
<p>将boost安装包解压至本地目录，如：E:\SDK\boost_1_45_0。因为boost一部分类是需要编译成库才能使用的，
所以我们还需要准备好boost专用的编译辅助工具bjam。在命令提示符（cmd.exe）中执行根目录下的bootstrap.bat，编译后的
bjam.exe会自动拷贝到该目录下（bjam必须与boost-build.jam在同级目录）。</p>
<p><span style="font-size: small;"><strong><span style="color: #666699;">三、编译</span>
</strong>
</span>
</p>
<div>接下来就是最重要的编译步骤了。需要打开命令提示符（cmd.exe）窗口并执行bjam，可以使用--help参数来查看命令帮
助。这里详细讲解一下bjam的命令行参数，因为它非常重要。首先，它涉及到编程环境的搭建，你需要根据自己今后具体的使用环境来选择合适的命令行参数；
其次，它影响到你的硬盘空间，完全编译的话据说在3G以上，如果你同时拥有2个以上的IDE（如VC6和VC9共存）而且都要用到boost，那么占用多
少硬盘就自己算吧……虽说如今大家的硬盘空间都不成问题，但就像本人一样崇尚合理利用资源不习惯铺张浪费提倡节俭的童子应该大有人在。综合以上两点因素，
本人使用的bjam命令如下：</div>
<p><span style="font-size: small;"></span>
</p>
<span style="font-size: small;">
<div class="cnblogs_code">
<span style="color: #000000;">bjamstage--toolset</span>
<span style="color: #000000;">=</span>
<span style="color: #000000;">msvc-</span>
<span style="color: #000000;">9.0</span>
<span id="aeaoofnhgocdbnbeljkmbjdmhbcokfdb-mousedown" style="color: #000000;">--without-graph --without-graph_parallel --without-math --without-mpi --without-python --without-serialization --without-wave<span id="aeaoofnhgocdbnbeljkmbjdmhbcokfdb-mousedown" style="color: #000000;">--stagedir</span>
<span style="color: #000000;">=</span>
<span style="color: #000000;">"</span>
<span style="color: #000000;">E:\SDK\boost_1_45_0\bin\vc9</span>
<span style="color: #000000;">"</span>
<span style="color: #000000;">link</span>
<span style="color: #000000;">=</span>
<span style="color: #000000;">staticruntime-link</span>
<span style="color: #000000;">=</span>
<span style="color: #000000;">sharedthreading</span>
<span style="color: #000000;">=</span>
<span style="color: #000000;">multi</span>
<span style="color: #000000;">debug</span>
<span style="color: #000000;">release</span>
</span>
</div>
</span>

<p><span style="color: #993366;"><span style="color: #993366;">下面详细解释一下每个参数的含义，请务必仔细看完：</span>
</span>
</p>
<div>
<strong>stage/install：</strong>
stage表示只生成库（dll和lib），install还会
生成包含头文件的include目录。本人推荐使用stage，因为install生成的这个include目录实际就是boost安装包解压缩后的
boost目录（E:\SDK\boost_1_45_0\boost，只比include目录多几个非hpp文件，都很小），所以可以直接使用，而且不
同的IDE都可以使用同一套头文件，这样既节省编译时间，也节省硬盘空间。</div>
<div>
<strong>toolset：</strong>
指定编译器，可选的如borland、gcc、msvc（VC6）、msvc-9.0（VS2008）等。</div>
<div>
<strong>without/with：</strong>
选择不编译/编译哪些库。因为python、mpi等库我都用不着，所以排除
之。另外，wave、graph、math、regex、test、program_options、serialization、signals这几个
库编出的静态lib都非常大，所以不需要的也可以without掉。这可以根据各人需要选择，默认是全部编译。但是需要注意，如果选择编译python的
话，是需要python语言支持的，应该到python官方主页<a title="http://www.python.org" href="http://www.python.org/" target="_blank">http://www.python.org/</a>
下载安装。</div>
<div>
<strong>stagedir/prefix：</strong>
stage时使用stagedir，install时使用
prefix，表示编译生成文件的路径。推荐给不同的IDE指定不同的目录，如VS2008对应的是E:\SDK\boost_1_45_0\bin
\vc9，VC6对应的是E:\SDK\boost_1_45_0\bin\vc6，否则都生成到一个目录下面，难以管理。如果使用了install参
数，那么还将生成头文件目录，vc9对应的就是E:\SDK\boost_1_45_0\bin\vc9\include\boost-1_45
\boost,vc6类似（光这路径都这样累赘，还是使用stage好）。</div>
<div>
<strong>build-dir：</strong>
编译生成的中间文件的路径。这个本人这里没用到，默认就在根目录（E:\SDK\boost_1_45_0）下，目录名为bin.v2，等编译完成后可将这个目录全部删除（没用了），所以不需要去设置。</div>
<div>
<strong>link：</strong>
生成动态链接库/静态链接库。生成动态链接库需使用shared方式，生成静态链接库需使用static方式。一般boost库可能都是以static方式编译，因为最终发布程序带着boost的dll感觉会比较累赘。</div>
<div>
<strong>runtime-link：</strong>
动态/静态链接C/C++运行时库。同样有shared和static两种方
式，这样runtime-link和link一共可以产生4种组合方式，各人可以根据自己的需要选择编译。一般link只选static的话，只需要编译
2种组合即可，即link=static runtime-link=shared和link=static runtime-link=static。</div>
<div>
<strong>threading：</strong>
单/多线程编译。一般都写多线程程序，当然要指定multi方式了；如果需要编写单线程程序，那么还需要编译单线程库，可以使用single方式。</div>
<div>
<strong>debug/release：</strong>
编译debug/release版本。一般都是程序的debug版本对应库的debug版本，所以两个都编译。</div>
<div>本人按以上方式分别编译了静态链接和动态链接两个版本后，整个E:\SDK\boost_1_45_0目录（包括安装包解压缩文件
和编译生成的库文件）只有不到500MB。事实上编译完成后安装包解压缩文件除了boost目录之外其他目录和文件已经可以删除了，这样还可以腾出
150MB的空间来。不过我又研究了一下，其实libs这个目录也很有用，它提供了所有Boost类的使用范例，平时可以作为参考；另外doc目录是一个
完整的boost使用帮助文档，当然最好也不要删了。这样剩下的几个目录和文件加起来也就十多兆，索性都给它们留一条生路吧。</div>
<div>呵呵，一个完整而又完美的boost目录就此诞生了。</div>
<div>如果图省事，不想了解这么多，那么有简单的方法，可以使用命令：</div>
<div>
<span style="font-size: small;"><span style="font-size: 13px;">
<div class="cnblogs_code">
<span style="color: #000000;">bjam--toolset</span>
<span style="color: #000000;">=</span>
<span style="color: #000000;">msvc-</span>
<span style="color: #000000;">9.0</span>
<span style="color: #000000;">--build-</span>
<span style="color: #000000;">type</span>
<span style="color: #000000;">=</span>
<span style="color: #000000;">complete</span>
</div>
</span>
</span>
</div>
<div>直接指定编译器以完全模式编译即可，这样可以满足今后的一切使用场合，但同时带来的后果是：</div>
<div>1、占用3G以上的硬盘空间<br>
2、占用若干小时的编译时间<br>
3、头文件和库文件存放于C:\Boost（个人非常反感）<br><p>4、生成的很多文件可以永远也用不上</p>
<p><span style="color: #666699; font-size: 16px; font-weight: bold;">四、配置</span>
</p>
</div>
<div>include目录：E:\SDK\boost_1_45_0</div>
<div>library目录：E:\SDK\boost_1_45_0\bin\vc9</div>
<p>添加到IDE相应的路径下面即可。</p>
<p><span style="font-size: small;"><strong><span style="color: #666699;">五、使用</span>
</strong>
</span>
</p>
<div>使用举例：</div>
<div>
<span style="font-size: small;"><span style="font-size: 13px;">
<div class="cnblogs_code">
<span style="color: #000000;">#include</span>
<span style="color: #000000;"><</span>
<span style="color: #000000;">boost\thread.hpp</span>
<span style="color: #000000;">></span>
</div>
</span>
</span>
</div>
<div>此时，不用包含库文件，boost的auto-link机制将会自动帮我们包含对应的静态lib。也就是说，boost默认是以静态方式链接的，这样我们的工程属性最好也设为Multi-threaded (Debug)。如果想使用dll动态方式链接，需要预先定义宏：</div>
<div>
<div class="cnblogs_code">
<span style="color: #0000ff;">#define</span>
<span style="color: #000000;">BOOST_ALL_DYN_LINK</span>
</div>
</div>
<div>同样，此时boost也会默认帮我们包含对应的lib。如果不想使用boost提供的auto-link机制，或者对它的自动链接不太放心的话（其实大可不必担心），可以预先定义宏：</div>
<div>
<div class="cnblogs_code">
<span style="color: #0000ff;">#define</span>
<span style="color: #000000;">BOOST_ALL_NO_LIB</span>
</div>
</div>
<div>然后使用以下方法链接：</div>
<div>
<div class="cnblogs_code">
<span style="color: #0000ff;">#pragma</span>
<span style="color: #000000;">comment(lib,"boost_thread-vc90-mt-1_45.lib")</span>
</div>
</div>
<div>或</div>
<div>
<div class="cnblogs_code">
<span style="color: #0000ff;">#pragma</span>
<span style="color: #000000;">comment(lib,"boost_thread-vc90-mt.lib")</span>
</div>
</div>
<div>这两个lib其实是一样的，实在不明白boost编译时为什么每个库都要复制一份，难道是因为后者在升级boost版本后不用改代码？另外还有一个比较有用的宏：</div>
<div>
<div class="cnblogs_code">
<span style="color: #0000ff;">#define</span>
<span style="color: #000000;">BOOST_LIB_DIAGNOSTIC</span>
</div>
</div>
<div>它可以让VC在编译时的output窗口中输出程序具体链接了哪些boost库以及链接顺序。</div>
<p>关于boost的auto-link机制，详细可以看看boost\config\auto_link.hpp里的代码，很容易可以读懂，并且值得我们学习。</p>
<p><span style="font-size: small;"><strong><span style="color: #666699;">六、Linux下编译与配置的区别：</span>
</strong>
</span>
</p>
<div>
<div>我的Linux与Windows使用了共享目录，将Windows下的E:\SDK目录映射成了Linux下的/mnt/hgfs/sdk目录。</div>
<div>所以我的boost源文件根目录就是/mnt/hgfs/sdk/boost_1_45_0，cd进去。</div>
<div>首先需要编译bjam：</div>
<div></div>
<div>
<div class="cnblogs_code">
<span style="color: #0000ff;">cd</span>
<span style="color: #000000;">tools</span>
<span style="color: #000000;">/</span>
<span style="color: #000000;">jam<br></span>
<span style="color: #000000;">./</span>
<span style="color: #000000;">build_dist</span>
<span style="color: #000000;">.</span>
<span style="color: #000000;">sh</span>
</div>
</div>
<div></div>
<div>我在虚拟机的Linux下编译bjam的时候最后会卡住，屏幕显示到mkdir的地方就不往下走了，不过其实这时候bajm已经编译完成。</div>
<div>接下来将stage/bin.linuxx86目录下生成的bjam拷贝到boost源文件根目录boost_1_45_0下，cd进去，开始编译boost：</div>
<div></div>
<div>
<div class="cnblogs_code">
<div>
<span style="color: #000000;">./</span>
<span style="color: #000000;">bjamstage--toolset</span>
<span style="color: #000000;">=</span>
<span style="color: #000000;">gcc--with-date_time--with-thread--with-filesystem--with-program_options--stagedir</span>
<span style="color: #000000;">=</span>
<span style="color: #000000;">"</span>
<span style="color: #000000;">/mnt/hgfs/sdk/boost_1_45_0/bin/gcc</span>
<span style="color: #000000;">"</span>
<span style="color: #000000;">link</span>
<span style="color: #000000;">=</span>
<span style="color: #000000;">staticruntime-link</span>
<span style="color: #000000;">=</span>
<span style="color: #000000;">staticthreading</span>
<span style="color: #000000;">=</span>
<span style="color: #000000;">multi</span>
<span>debug</span>
<span></span>
<span style="color: #000000;">release</span>
</div>
</div>
<div></div>
<div>这些参数的意义与Windows下完全一样，只不过编译器改成gcc，其他选项根据自己的需要进行设置。</div>
<div>生成的库文件就在bin/gcc/lib目录下，与vc9编译的一样，lib目录感觉是多余的，手动将库文件拷贝到gcc目录下，删掉lib目录，这属于个人喜好问题。</div>
<div>然后把中间文件全部删掉，包括bin.v2目录和tools/jam/stage目录。</div>
<div>关于boost库的使用，为了不用每次写makefile都把boost的头文件和库文件的路径带着，而且为了让跨平台程序公用一套代码，</div>
<div>可以将boost的头文件和库文件路径加到Linux的环境变量中。打开/etc/profile，加入以下gcc环境变量：</div>
<div></div>
<div class="cnblogs_code">
<div>
<span style="color: #000000;">CPLUS_INCLUDE_PATH</span>
<span style="color: #000000;">=$</span>
<span style="color: #000000;">CPLUS_INCLUDE_PATH:</span>
<span style="color: #000000;">"</span>
<span style="color: #000000;">/mnt/hgfs/sdk/boost_1_45_0</span>
<span style="color: #000000;">"</span>
<span style="color: #000000;"><br>
exportCPLUS_INCLUDE_PATH<br><br>
LIBRARY_PATH</span>
<span style="color: #000000;">=$</span>
<span style="color: #000000;">LIBRARY_PATH:</span>
<span style="color: #000000;">"</span>
<span style="color: #000000;">/mnt/hgfs/sdk/boost_1_45_0/bin/gcc</span>
<span style="color: #000000;">"</span>
<span style="color: #000000;"><br>
exportLIBRARY_PATH</span>
</div>
</div>
<div></div>
<p>这样就可以直接使用boost的头文件和库文件了，并且与Windows共用一套代码，非常方便。</p>
</div>
</div>
<p><span style="font-size: small;"><strong><span style="color: #666699;">七、可参考的网上流行的几篇文章：</span>
</strong>
</span>
</p>
<div>
<div>白话C++之安装boost：<a title="http://www.d2school.com/bhcpp_book/2_5.php" href="http://www.d2school.com/bhcpp_book/2_5.php" target="_blank">http://www.d2school.com/bhcpp_book/2_5.php</a>
</div>
</div>
<div>Windows VC6编译安装Boost库：<a title="http://blog.youkuaiyun.com/weekly123/archive/2007/11/23/1899188.aspx" href="http://blog.youkuaiyun.com/weekly123/archive/2007/11/23/1899188.aspx" target="_blank">http://blog.youkuaiyun.com/weekly123/archive/2007/11/23/1899188.aspx</a>
</div>
<div>boost编译步骤：<a title="http://blog.youkuaiyun.com/aheroofeast/archive/2009/03/22/4015458.aspx" href="http://blog.youkuaiyun.com/aheroofeast/archive/2009/03/22/4015458.aspx" target="_blank">http://blog.youkuaiyun.com/aheroofeast/archive/2009/03/22/4015458.aspx</a>
</div>
<div>boost 1.35.0 Visual Studio 2008编译指南：<a title="http://blog.youkuaiyun.com/benjiamen/archive/2008/07/12/2643705.aspx" href="http://blog.youkuaiyun.com/benjiamen/archive/2008/07/12/2643705.aspx" target="_blank">http://blog.youkuaiyun.com/benjiamen/archive/2008/07/12/2643705.aspx</a>
</div>
<div>VS2008下安装boost:<a title="http://www.cnblogs.com/xdotnet/archive/2008/03/22/boost_install_config.html" href="http://www.cnblogs.com/xdotnet/archive/2008/03/22/boost_install_config.html" target="_blank">http://www.cnblogs.com/xdotnet/archive/2008/03/22/boost_install_config.html</a>
</div>
</div>
</div>