Boost下載下傳安裝編譯配置使用指南(轉）

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:/SDK/boost_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:/SDK/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:/SDK/boost_1_39_0/boost，隻比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:/SDK/boost_1_39_0/vc9/lib，VC6對應的是E:/SDK/boost_1_39_0/vc6/lib，否則都生成到一個目錄下面，難以管理。如果使用了install參數，那麼還将生成頭檔案目錄，vc9對應的就是E:/SDK/boost_1_39_0/vc9/include/boost-1_39/boost,vc6類似（光這路徑都這樣累贅，還是使用stage好）。

build-dir：編譯生成的中間檔案的路徑。這個本人這裡沒用到，預設就在根目錄（E:/SDK/boost_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:/SDK/boost_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:/SDK/boost_1_39_0 library目錄：E:/SDK/boost_1_39_0/vc9/lib

添加到IDE相應的路徑下面即可。

五、使用

使用舉例：

#include  < boost/thread.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機制，詳細可以看看boost/config/auto_link.hpp裡的代碼，很容易可以讀懂，并且值得我們學習。

六、不推薦的網上流行的幾篇參考文章：

Windows VC6編譯安裝Boost庫： http://blog.csdn.net/weekly123/archive/2007/11/23/1899188.aspx boost編譯步驟： http://blog.csdn.net/aheroofeast/archive/2009/03/22/4015458.aspx boost 1.35.0 Visual Studio 2008編譯指南： http://blog.csdn.net/benjiamen/archive/2008/07/12/2643705.aspx VS2008下安裝boost: http://www.cnblogs.com/xdotnet/archive/2008/03/22/boost_install_config.html 白話C++之安裝boost： http://www.d2school.com/bhcpp_book/2_5.php