http://dev.csdn.net/develop/article/20/20025.shtm

概述
——

什么是makefile？或許很多Winodws的程序員都不知道這個東西，因為那些 Windows的IDE都為你做了這個工作，但我覺得要作一個好的和professional的程序員，makefile還是要懂。這就好像現(xiàn)在有這么多 的HTML的編輯器，但如果你想成為一個專業(yè)人士，你還是要了解HTML的標識的含義。特別在Unix下的軟件編譯，你就不能不自己寫makefile 了，會不會寫makefile，從一個側(cè)面說明了一個人是否具備完成大型工程的能力。

因為，makefile關(guān)系到了整個工程的編譯規(guī)則。一個工程中的源文件不計數(shù)，其按類型、功 能、模塊分別放在若干個目錄中，makefile定義了一系列的規(guī)則來指定，哪些文件需要先編譯，哪些文件需要后編譯，哪些文件需要重新編譯，甚至于進行 更復雜的功能操作，因為makefile就像一個Shell腳本一樣，其中也可以執(zhí)行操作系統(tǒng)的命令。

makefile帶來的好處就是——“自動化編譯”，一旦寫好，只需要一個make命令，整個 工程完全自動編譯，極大的提高了軟件開發(fā)的效率。make是一個命令工具，是一個解釋makefile中指令的命令工具，一般來說，大多數(shù)的IDE都有這 個命令，比如：Delphi的make，Visual C++的nmake，Linux下GNU的make。可見，makefile都成為了一種在工程方面的編譯方法。

現(xiàn)在講述如何寫makefile的文章比較少，這是我想寫這篇文章的原因。當然，不同產(chǎn)商的 make各不相同，也有不同的語法，但其本質(zhì)都是在“文件依賴性”上做文章，這里，我僅對GNU的make進行講述，我的環(huán)境是RedHat Linux 8.0，make的版本是3.80。必竟，這個make是應用最為廣泛的，也是用得最多的。而且其還是最遵循于IEEE 1003.2-1992 標準的（POSIX.2）。

在這篇文檔中，將以C/C++的源碼作為我們基礎，所以必然涉及一些關(guān)于C/C++的編譯的知識，相關(guān)于這方面的內(nèi)容，還請各位查看相關(guān)的編譯器的文檔。這里所默認的編譯器是UNIX下的GCC和CC。

 

關(guān)于程序的編譯和鏈接
——————————

在此，我想多說關(guān)于程序編譯的一些規(guī)范和方法，一般來說，無論是C、C++、還是pas，首先 要把源文件編譯成中間代碼文件，在Windows下也就是 .obj 文件，UNIX下是 .o 文件，即 Object File，這個動作叫做編譯（compile）。然后再把大量的Object File合成執(zhí)行文件，這個動作叫作鏈接（link）。

編譯時，編譯器需要的是語法的正確，函數(shù)與變量的聲明的正確。對于后者，通常是你需要告訴編譯 器頭文件的所在位置（頭文件中應該只是聲明，而定義應該放在C/C++文件中），只要所有的語法正確，編譯器就可以編譯出中間目標文件。一般來說，每個源 文件都應該對應于一個中間目標文件（O文件或是OBJ文件）。

鏈接時，主要是鏈接函數(shù)和全局變量，所以，我們可以使用這些中間目標文件（O文件或是OBJ文 件）來鏈接我們的應用程序。鏈接器并不管函數(shù)所在的源文件，只管函數(shù)的中間目標文件（Object File），在大多數(shù)時候，由于源文件太多，編譯生成的中間目標文件太多，而在鏈接時需要明顯地指出中間目標文件名，這對于編譯很不方便，所以，我們要給 中間目標文件打個包，在Windows下這種包叫“庫文件”（Library File)，也就是 .lib 文件，在UNIX下，是Archive File，也就是 .a 文件。

總結(jié)一下，源文件首先會生成中間目標文件，再由中間目標文件生成執(zhí)行文件。在編譯時，編譯器只 檢測程序語法，和函數(shù)、變量是否被聲明。如果函數(shù)未被聲明，編譯器會給出一個警告，但可以生成Object File。而在鏈接程序時，鏈接器會在所有的Object File中找尋函數(shù)的實現(xiàn)，如果找不到，那到就會報鏈接錯誤碼（Linker Error），在VC下，這種錯誤一般是：Link 2001錯誤，意思說是說，鏈接器未能找到函數(shù)的實現(xiàn)。你需要指定函數(shù)的Object File.

好，言歸正傳，GNU的make有許多的內(nèi)容，閑言少敘，還是讓我們開始吧。

 

Makefile 介紹
———————

make命令執(zhí)行時，需要一個 Makefile 文件，以告訴make命令需要怎么樣的去編譯和鏈接程序。

首先，我們用一個示例來說明Makefile的書寫規(guī)則。以便給大家一個感興認識。這個示例來源于GNU的make使用手冊，在這個示例中，我們的工程有8個C文件，和3個頭文件，我們要寫一個Makefile來告訴make命令如何編譯和鏈接這幾個文件。我們的規(guī)則是：
    1）如果這個工程沒有編譯過，那么我們的所有C文件都要編譯并被鏈接。
    2）如果這個工程的某幾個C文件被修改，那么我們只編譯被修改的C文件，并鏈接目標程序。
    3）如果這個工程的頭文件被改變了，那么我們需要編譯引用了這幾個頭文件的C文件，并鏈接目標程序。

只要我們的Makefile寫得夠好，所有的這一切，我們只用一個make命令就可以完成，make命令會自動智能地根據(jù)當前的文件修改的情況來確定哪些文件需要重編譯，從而自己編譯所需要的文件和鏈接目標程序。

一、Makefile的規(guī)則

在講述這個Makefile之前，還是讓我們先來粗略地看一看Makefile的規(guī)則。

    target ... : prerequisites ...
            command
            ...
            ...

    target也就是一個目標文件，可以是Object File，也可以是執(zhí)行文件。還可以是一個標簽（Label），對于標簽這種特性，在后續(xù)的“偽目標”章節(jié)中會有敘述。

    prerequisites就是，要生成那個target所需要的文件或是目標。

    command也就是make需要執(zhí)行的命令。（任意的Shell命令）

這是一個文件的依賴關(guān)系，也就是說，target這一個或多個的目標文件依賴于 prerequisites中的文件，其生成規(guī)則定義在command中。說白一點就是說，prerequisites中如果有一個以上的文件比 target文件要新的話，command所定義的命令就會被執(zhí)行。這就是Makefile的規(guī)則。也就是Makefile中最核心的內(nèi)容。

說到底，Makefile的東西就是這樣一點，好像我的這篇文檔也該結(jié)束了。呵呵。還不盡然，這是Makefile的主線和核心，但要寫好一個Makefile還不夠，我會以后面一點一點地結(jié)合我的工作經(jīng)驗給你慢慢到來。內(nèi)容還多著呢。：）

二、一個示例

正如前面所說的，如果一個工程有3個頭文件，和8個C文件，我們?yōu)榱送瓿汕懊嫠龅哪侨齻€規(guī)則，我們的Makefile應該是下面的這個樣子的。

    edit : main.o kbd.o command.o display.o \
           insert.o search.o files.o utils.o
            cc -o edit main.o kbd.o command.o display.o \
                       insert.o search.o files.o utils.o

    main.o : main.c defs.h
            cc -c main.c
    kbd.o : kbd.c defs.h command.h
            cc -c kbd.c
    command.o : command.c defs.h command.h
            cc -c command.c
    display.o : display.c defs.h buffer.h
            cc -c display.c
    insert.o : insert.c defs.h buffer.h
            cc -c insert.c
    search.o : search.c defs.h buffer.h
            cc -c search.c
    files.o : files.c defs.h buffer.h command.h
            cc -c files.c
    utils.o : utils.c defs.h
            cc -c utils.c
    clean :
            rm edit main.o kbd.o command.o display.o \
               insert.o search.o files.o utils.o

反斜杠（\）是換行符的意思。這樣比較便于Makefile的易讀。我們可以把這個內(nèi)容保存在 文件為“Makefile”或“makefile”的文件中，然后在該目錄下直接輸入命令“make”就可以生成執(zhí)行文件edit。如果要刪除執(zhí)行文件和 所有的中間目標文件，那么，只要簡單地執(zhí)行一下“make clean”就可以了。

在這個makefile中，目標文件（target）包含：執(zhí)行文件edit和中間目標文件 （*.o），依賴文件（prerequisites）就是冒號后面的那些 .c 文件和 .h文件。每一個 .o 文件都有一組依賴文件，而這些 .o 文件又是執(zhí)行文件 edit 的依賴文件。依賴關(guān)系的實質(zhì)上就是說明了目標文件是由哪些文件生成的，換言之，目標文件是哪些文件更新的。

在定義好依賴關(guān)系后，后續(xù)的那一行定義了如何生成目標文件的操作系統(tǒng)命令，一定要以一個Tab 鍵作為開頭。記住，make并不管命令是怎么工作的，他只管執(zhí)行所定義的命令。make會比較targets文件和prerequisites文件的修改 日期，如果prerequisites文件的日期要比targets文件的日期要新，或者target不存在的話，那么，make就會執(zhí)行后續(xù)定義的命 令。

這里要說明一點的是，clean不是一個文件，它只不過是一個動作名字，有點像C語言中的 lable一樣，其冒號后什么也沒有，那么，make就不會自動去找文件的依賴性，也就不會自動執(zhí)行其后所定義的命令。要執(zhí)行其后的命令，就要在make 命令后明顯得指出這個lable的名字。這樣的方法非常有用，我們可以在一個makefile中定義不用的編譯或是和編譯無關(guān)的命令，比如程序的打包，程 序的備份，等等。

三、make是如何工作的

在默認的方式下，也就是我們只輸入make命令。那么，

    1、make會在當前目錄下找名字叫“Makefile”或“makefile”的文件。
    2、如果找到，它會找文件中的第一個目標文件（target），在上面的例子中，他會找到“edit”這個文件，并把這個文件作為最終的目標文件。
    3、如果edit文件不存在，或是edit所依賴的后面的 .o 文件的文件修改時間要比edit這個文件新，那么，他就會執(zhí)行后面所定義的命令來生成edit這個文件。
    4、如果edit所依賴的.o文件也存在，那么make會在當前文件中找目標為.o文件的依賴性，如果找到則再根據(jù)那一個規(guī)則生成.o文件。（這有點像一個堆棧的過程）
    5、當然，你的C文件和H文件是存在的啦，于是make會生成 .o 文件，然后再用 .o 文件生命make的終極任務，也就是執(zhí)行文件edit了。

這就是整個make的依賴性，make會一層又一層地去找文件的依賴關(guān)系，直到最終編譯出第一 個目標文件。在找尋的過程中，如果出現(xiàn)錯誤，比如最后被依賴的文件找不到，那么make就會直接退出，并報錯，而對于所定義的命令的錯誤，或是編譯不成 功，make根本不理。make只管文件的依賴性，即，如果在我找了依賴關(guān)系之后，冒號后面的文件還是不在，那么對不起，我就不工作啦。

通過上述分析，我們知道，像clean這種，沒有被第一個目標文件直接或間接關(guān)聯(lián)，那么它后面所定義的命令將不會被自動執(zhí)行，不過，我們可以顯示要make執(zhí)行。即命令——“make clean”，以此來清除所有的目標文件，以便重編譯。

于是在我們編程中，如果這個工程已被編譯過了，當我們修改了其中一個源文件，比如 file.c，那么根據(jù)我們的依賴性，我們的目標file.o會被重編譯（也就是在這個依性關(guān)系后面所定義的命令），于是file.o的文件也是最新的 啦，于是file.o的文件修改時間要比edit要新，所以edit也會被重新鏈接了（詳見edit目標文件后定義的命令）。

而如果我們改變了“command.h”，那么，kdb.o、command.o和files.o都會被重編譯，并且，edit會被重鏈接。

四、makefile中使用變量

在上面的例子中，先讓我們看看edit的規(guī)則：

      edit : main.o kbd.o command.o display.o \
                  insert.o search.o files.o utils.o
            cc -o edit main.o kbd.o command.o display.o \
                       insert.o search.o files.o utils.o

我們可以看到[.o]文件的字符串被重復了兩次，如果我們的工程需要加入一個新的[.o]文 件，那么我們需要在兩個地方加（應該是三個地方，還有一個地方在clean中）。當然，我們的makefile并不復雜，所以在兩個地方加也不累，但如果 makefile變得復雜，那么我們就有可能會忘掉一個需要加入的地方，而導致編譯失敗。所以，為了makefile的易維護，在makefile中我們 可以使用變量。makefile的變量也就是一個字符串，理解成C語言中的宏可能會更好。

比如，我們聲明一個變量，叫objects, OBJECTS, objs, OBJS, obj, 或是 OBJ，反正不管什么啦，只要能夠表示obj文件就行了。我們在makefile一開始就這樣定義：

     objects = main.o kbd.o command.o display.o \
              insert.o search.o files.o utils.o

于是，我們就可以很方便地在我們的makefile中以“$(objects)”的方式來使用這個變量了，于是我們的改良版makefile就變成下面這個樣子：

    objects = main.o kbd.o command.o display.o \
              insert.o search.o files.o utils.o

    edit : $(objects)
            cc -o edit $(objects)
    main.o : main.c defs.h
            cc -c main.c
    kbd.o : kbd.c defs.h command.h
            cc -c kbd.c
    command.o : command.c defs.h command.h
            cc -c command.c
    display.o : display.c defs.h buffer.h
            cc -c display.c
    insert.o : insert.c defs.h buffer.h
            cc -c insert.c
    search.o : search.c defs.h buffer.h
            cc -c search.c
    files.o : files.c defs.h buffer.h command.h
            cc -c files.c
    utils.o : utils.c defs.h
            cc -c utils.c
    clean :
            rm edit $(objects)

于是如果有新的 .o 文件加入，我們只需簡單地修改一下 objects 變量就可以了。

關(guān)于變量更多的話題，我會在后續(xù)給你一一道來。

五、讓make自動推導

GNU的make很強大，它可以自動推導文件以及文件依賴關(guān)系后面的命令，于是我們就沒必要去在每一個[.o]文件后都寫上類似的命令，因為，我們的make會自動識別，并自己推導命令。

只要make看到一個[.o]文件，它就會自動的把[.c]文件加在依賴關(guān)系中，如果make 找到一個whatever.o，那么whatever.c，就會是whatever.o的依賴文件。并且 cc -c whatever.c 也會被推導出來，于是，我們的makefile再也不用寫得這么復雜。我們的是新的makefile又出爐了。

    objects = main.o kbd.o command.o display.o \
              insert.o search.o files.o utils.o

    edit : $(objects)
            cc -o edit $(objects)

    main.o : defs.h
    kbd.o : defs.h command.h
    command.o : defs.h command.h
    display.o : defs.h buffer.h
    insert.o : defs.h buffer.h
    search.o : defs.h buffer.h
    files.o : defs.h buffer.h command.h
    utils.o : defs.h

    .PHONY : clean
    clean :
            rm edit $(objects)

這種方法，也就是make的“隱晦規(guī)則”。上面文件內(nèi)容中，“.PHONY”表示，clean是個偽目標文件。

關(guān)于更為詳細的“隱晦規(guī)則”和“偽目標文件”，我會在后續(xù)給你一一道來。

六、另類風格的makefile

即然我們的make可以自動推導命令，那么我看到那堆[.o]和[.h]的依賴就有點不爽，那么多的重復的[.h]，能不能把其收攏起來，好吧，沒有問題，這個對于make來說很容易，誰叫它提供了自動推導命令和文件的功能呢？來看看最新風格的makefile吧。

    objects = main.o kbd.o command.o display.o \
              insert.o search.o files.o utils.o

    edit : $(objects)
            cc -o edit $(objects)

    $(objects) : defs.h
    kbd.o command.o files.o : command.h
    display.o insert.o search.o files.o : buffer.h

    .PHONY : clean
    clean :
            rm edit $(objects)

這種風格，讓我們的makefile變得很簡單，但我們的文件依賴關(guān)系就顯得有點凌亂了。魚和熊掌不可兼得。還看你的喜好了。我是不喜歡這種風格的，一是文件的依賴關(guān)系看不清楚，二是如果文件一多，要加入幾個新的.o文件，那就理不清楚了。

七、清空目標文件的規(guī)則

每個Makefile中都應該寫一個清空目標文件（.o和執(zhí)行文件）的規(guī)則，這不僅便于重編譯，也很利于保持文件的清潔。這是一個“修養(yǎng)”（呵呵，還記得我的《編程修養(yǎng)》嗎）。一般的風格都是：

        clean:
            rm edit $(objects)

更為穩(wěn)健的做法是：

        .PHONY : clean
        clean :
                -rm edit $(objects)

前面說過，.PHONY意思表示clean是一個“偽目標”，。而在rm命令前面加了一個小減 號的意思就是，也許某些文件出現(xiàn)問題，但不要管，繼續(xù)做后面的事。當然，clean的規(guī)則不要放在文件的開頭，不然，這就會變成make的默認目標，相信 誰也不愿意這樣。不成文的規(guī)矩是——“clean從來都是放在文件的最后”。

上面就是一個makefile的概貌，也是makefile的基礎，下面還有很多makefile的相關(guān)細節(jié)，準備好了嗎？準備好了就來。

一、Makefile里有什么？

Makefile里主要包含了五個東西：顯式規(guī)則、隱晦規(guī)則、變量定義、文件指示和注釋。

1、顯式規(guī)則。顯式規(guī)則說明了，如何生成一個或多的的目標文件。這是由Makefile的書寫者明顯指出，要生成的文件，文件的依賴文件，生成的命令。

2、隱晦規(guī)則。由于我們的make有自動推導的功能，所以隱晦的規(guī)則可以讓我們比較粗糙地簡略地書寫Makefile，這是由make所支持的。

3、變量的定義。在Makefile中我們要定義一系列的變量，變量一般都是字符串，這個有點你C語言中的宏，當Makefile被執(zhí)行時，其中的變量都會被擴展到相應的引用位置上。

4、文件指示。其包括了三個部分，一個是在一個Makefile中引用另一個 Makefile，就像C語言中的include一樣；另一個是指根據(jù)某些情況指定Makefile中的有效部分，就像C語言中的預編譯#if一樣；還有 就是定義一個多行的命令。有關(guān)這一部分的內(nèi)容，我會在后續(xù)的部分中講述。

5、注釋。Makefile中只有行注釋，和UNIX的Shell腳本一樣，其注釋是用“#”字符，這個就像C/C++中的“//”一樣。如果你要在你的Makefile中使用“#”字符，可以用反斜框進行轉(zhuǎn)義，如：“\#”。

最后，還值得一提的是，在Makefile中的命令，必須要以[Tab]鍵開始。

二、Makefile的文件名

默認的情況下，make命令會在當前目錄下按順序找尋文件名為“GNUmakefile”、 “makefile”、“Makefile”的文件，找到了解釋這個文件。在這三個文件名中，最好使用“Makefile”這個文件名，因為，這個文件名 第一個字符為大寫，這樣有一種顯目的感覺。最好不要用“GNUmakefile”，這個文件是GNU的make識別的。有另外一些make只對全小寫的 “makefile”文件名敏感，但是基本上來說，大多數(shù)的make都支持“makefile”和“Makefile”這兩種默認文件名。

當然，你可以使用別的文件名來書寫Makefile，比 如：“Make.Linux”，“Make.Solaris”，“Make.AIX”等，如果要指定特定的Makefile，你可以使用make的“- f”和“--file”參數(shù)，如：make -f Make.Linux或make --file Make.AIX。

三、引用其它的Makefile

在Makefile使用include關(guān)鍵字可以把別的Makefile包含進來，這很像C語言的#include，被包含的文件會原模原樣的放在當前文件的包含位置。include的語法是：

    include <filename>

    filename可以是當前操作系統(tǒng)Shell的文件模式（可以保含路徑和通配符）

在include前面可以有一些空字符，但是絕不能是[Tab]鍵開始。include 和<filename>可以用一個或多個空格隔開。舉個例子，你有這樣幾個Makefile：a.mk、b.mk、c.mk，還有一個文件叫 foo.make，以及一個變量$(bar)，其包含了e.mk和f.mk，那么，下面的語句：

    include foo.make *.mk $(bar)

    等價于：

    include foo.make a.mk b.mk c.mk e.mk f.mk

make命令開始時，會把找尋include所指出的其它Makefile，并把其內(nèi)容安置在 當前的位置。就好像C/C++的#include指令一樣。如果文件都沒有指定絕對路徑或是相對路徑的話，make會在當前目錄下首先尋找，如果當前目錄 下沒有找到，那么，make還會在下面的幾個目錄下找：

    1、如果make執(zhí)行時，有“-I”或“--include-dir”參數(shù)，那么make就會在這個參數(shù)所指定的目錄下去尋找。
    2、如果目錄<prefix>/include（一般是：/usr/local/bin或/usr/include）存在的話，make也會去找。

如果有文件沒有找到的話，make會生成一條警告信息，但不會馬上出現(xiàn)致命錯誤。它會繼續(xù)載入 其它的文件，一旦完成makefile的讀取，make會再重試這些沒有找到，或是不能讀取的文件，如果還是不行，make才會出現(xiàn)一條致命信息。如果你 想讓make不理那些無法讀取的文件，而繼續(xù)執(zhí)行，你可以在include前加一個減號“-”。如：

    -include <filename>
    其表示，無論include過程中出現(xiàn)什么錯誤，都不要報錯繼續(xù)執(zhí)行。和其它版本make兼容的相關(guān)命令是sinclude，其作用和這一個是一樣的。

四、環(huán)境變量 MAKEFILES

如果你的當前環(huán)境中定義了環(huán)境變量MAKEFILES，那么，make會把這個變量中的值做一 個類似于include的動作。這個變量中的值是其它的Makefile，用空格分隔。只是，它和include不同的是，從這個環(huán)境變中引入的 Makefile的“目標”不會起作用，如果環(huán)境變量中定義的文件發(fā)現(xiàn)錯誤，make也會不理。

但是在這里我還是建議不要使用這個環(huán)境變量，因為只要這個變量一被定義，那么當你使用make 時，所有的Makefile都會受到它的影響，這絕不是你想看到的。在這里提這個事，只是為了告訴大家，也許有時候你的Makefile出現(xiàn)了怪事，那么 你可以看看當前環(huán)境中有沒有定義這個變量。

五、make的工作方式

GNU的make工作時的執(zhí)行步驟入下：（想來其它的make也是類似）

    1、讀入所有的Makefile。
    2、讀入被include的其它Makefile。
    3、初始化文件中的變量。
    4、推導隱晦規(guī)則，并分析所有規(guī)則。
    5、為所有的目標文件創(chuàng)建依賴關(guān)系鏈。
    6、根據(jù)依賴關(guān)系，決定哪些目標要重新生成。
    7、執(zhí)行生成命令。

1-5步為第一個階段，6-7為第二個階段。第一個階段中，如果定義的變量被使用了，那 么，make會把其展開在使用的位置。但make并不會完全馬上展開，make使用的是拖延戰(zhàn)術(shù)，如果變量出現(xiàn)在依賴關(guān)系的規(guī)則中，那么僅當這條依賴被決 定要使用了，變量才會在其內(nèi)部展開。

當然，這個工作方式你不一定要清楚，但是知道這個方式你也會對make更為熟悉。有了這個基礎，后續(xù)部分也就容易看懂了。