跟我一起寫 Makefile - 4. 書寫命令
跟我一起寫 Makefile - 4. 書寫命令
4. 書寫命令
每條規則中的命令和作業系統 shell 的命令列是一致的。make 會按順序一條一條的執行命令，每條命令的開頭必須以 Tab 鍵開頭，除非命令是緊跟在依賴規則後面的分號後的。在命令列之間中的空格或是空行會被忽略，但是如果該空格或空行是以 Tab 鍵開頭的，那麼 make 會認為其是一個空命令。
我們在 Unix 下可能會使用不同的 shell，但是 make 的命令預設是被 /bin/sh - Unix 的標準 shell 解釋執行的。除非你特別指定一個其它的 shell。Makefile 中，# 是註釋符，類似 C/C++ 中的 //，其後的本行字元都被註釋。
4.1 顯示命令
通常 make 會把其要執行的命令列在命令執行前輸出到螢幕上。當我們用 @ 字元在命令列前，那麼這個命令將不被 make 顯示出來，最具代表性的例子是，我們用這個功能來向螢幕顯示一些資訊。
@echo 正在編譯XXX模組......
當 make 執行時，會輸出“正在編譯XXX模組…”字串，但不會輸出命令，如果沒有 @，那麼 make 將輸出：
echo 正在編譯XXX模組......
正在編譯XXX模組......
如果 make 執行時，帶入 make 引數 -n 或 --just-print，其只是顯示命令，但不會執行命令，這個功能很有利於我們除錯我們的 Makefile，看看我們書寫的命令在執行起來是什麼樣子的或是什麼順序的。
而 make 引數 -s 或 --silent 則是全面禁止命令的顯示。
4.2 命令執行
當依賴目標新於目標時，也就是當規則的目標需要被更新時，make 會一條一條的執行其後的命令。需要注意的是，如果你要讓上一條命令的結果應用在下一條命令時，你應該使用分號分隔這兩條命令。比如你的第一條命令是 cd 命令，你希望第二條命令得在 cd 之後的基礎上執行，那麼你就不能把這兩條命令寫在兩行上，而應該把這兩條命令寫在一行上，用分號分隔。
示例一：
exec:
cd /home/hchen
pwd
示例二：
exec:
cd /home/hchen; pwd
當我們執行 make exec 時，第一個例子中的 cd 沒有作用，pwd 會打印出當前的 Makefile 目錄。第二個例子中，cd 起作用了，pwd 會打印出 /home/hchen。
make 一般是使用環境變數 SHELL 中所定義的系統 shell 來執行命令，預設情況下使用 Unix 的標準 shell - /bin/sh 來執行命令。但在 MS-DOS 下有點特殊，因為 MS-DOS 下沒有 SHELL 環境變數，當然你也可以指定。如果你指定了 Unix 風格的目錄形式，make 首先會在 SHELL 所指定的路徑中找尋命令直譯器。如果找不到，其會在當前碟符中的當前目錄中尋找，如果再找不到，其會在 PATH 環境變數中所定義的所有路徑中尋找。MS-DOS 中，如果你定義的命令直譯器沒有找到，其會給你的命令直譯器加上諸如 .exe、.com、.bat、.sh 等字尾。
4.3 命令出錯
每當命令執行完後，make 會檢測每個命令的返回碼，如果命令返回成功，那麼 make 會執行下一條命令。當規則中所有的命令成功返回後，這個規則就算是成功完成了。如果一個規則中的某個命令出錯了 (命令退出碼非零)，那麼 make 就會終止執行當前規則，這將有可能終止所有規則的執行。
有些時候，命令的出錯並不表示就是錯誤的。例如 mkdir 命令，我們一定需要建立一個目錄，如果目錄不存在，那麼 mkdir 就成功執行。如果目錄存在，那麼就出錯了。我們之所以使用 mkdir 的意思就是一定要有這樣的一個目錄，於是我們就不希望 mkdir 出錯而終止規則的執行。
為了做到這一點，忽略命令的出錯，我們可以在 Makefile 的命令列前加一個減號 - (在 Tab 鍵之後)，標記為不管命令出不出錯都認為是成功的。
clean:
-rm -f *.o
還有一個全域性的辦法是，給 make 加上 -i 或是 --ignore-errors 引數，那麼 Makefile 中所有命令都會忽略錯誤。而如果一個規則是以 .IGNORE 作為目標的，那麼這個規則中的所有命令將會忽略錯誤。這些是不同級別的防止命令出錯的方法，你可以根據你的不同喜歡設定。
還有一個要提一下的 make 的引數的是 -k 或是 --keep-going，這個引數的意思是，如果某規則中的命令出錯了，那麼就終止該規則的執行，但繼續執行其它規則。
4.4 巢狀執行 make
在工程中，我們會把我們不同模組或是不同功能的原始檔放在不同的目錄中，我們可以在每個目錄中都書寫一個該目錄的 Makefile，這有利於讓我們的 Makefile 變得更加地簡潔，而不至於把所有的東西全部寫在一個 Makefile 中，這樣會很難維護我們的 Makefile，這個技術對於我們模組編譯和分段編譯有著非常大的好處。
例如，我們有一個子目錄叫 subdir，這個目錄下有個 Makefile 檔案，來指明瞭這個目錄下檔案的編譯規則。那麼我們總控的 Makefile 可以這樣書寫：
subsystem:
cd subdir && $(MAKE)
其等價於：
subsystem:
$(MAKE) -C subdir
定義 $(MAKE) 巨集變數的意思是，也許我們的 make 需要一些引數，所以定義成一個變數比較利於維護。這兩個例子的意思都是先進入 subdir 目錄，然後執行 make 命令。
我們把這個 Makefile 叫做總控 Makefile，總控 Makefile 的變數可以傳遞到下級的 Makefile 中 (如果你顯示的宣告)，但是不會覆蓋下層的 Makefile 中所定義的變數，除非指定了 -e 引數。
如果你要傳遞變數到下級 Makefile 中，那麼你可以使用這樣的宣告：
export <variable ...>;
如果你不想讓某些變數傳遞到下級 Makefile 中，那麼你可以這樣宣告：
unexport <variable ...>;
示例一：
export variable = value
其等價於：
variable = value
export variable
其等價於：
export variable := value
其等價於：
variable := value
export variable
示例二：
export variable += value
其等價於：
variable += value
export variable
如果你要傳遞所有的變數，那麼只要一個 export 就行了。後面什麼也不用跟，表示傳遞所有的變數。
需要注意的是，有兩個變數，一個是 SHELL，一個是 MAKEFLAGS，這兩個變數不管你是否 export，其總是要傳遞到下層 Makefile 中。特別是 MAKEFILES 變數，其中包含了 make 的引數資訊。
如果我們執行總控 Makefile 時有 make 引數或是在上層 Makefile 中定義了這個變數，那麼 MAKEFILES 變數將會是這些引數，並會傳遞到下層 Makefile 中，這是一個系統級的環境變數。
但是 make 命令中的有幾個引數並不往下傳遞，它們是 -C, -f, -h, -o 和 -W。如果你不想往下層傳遞引數，你可以這樣來：
subsystem:
cd subdir && $(MAKE) MAKEFLAGS=
如果你定義了環境變數 MAKEFLAGS，那麼你得確信其中的選項是大家都會用到的，如果其中有 -t, -n 和 -q 引數，那麼將會有讓你意想不到的結果，或許會讓你異常地恐慌。
還有一個在巢狀執行中比較有用的引數，-w 或是 --print-directory 會在 make 的過程中輸出一些資訊，讓你看到目前的工作目錄。如果我們的下級 make 目錄是 /home/hchen/gnu/make，如果我們使用 make -w 來執行，那麼當進入該目錄時，我們會看到：
make: Entering directory `/home/hchen/gnu/make'.
而在完成下層 make 後離開目錄時，我們會看到：
make: Leaving directory `/home/hchen/gnu/make'
當你使用 -C 引數來指定 make 下層 Makefile 時，-w 會被自動開啟的。如果引數中有 -s (–slient) 或是 --no-print-directory，那麼 -w 總是失效的。
4.5 定義命令包
如果 Makefile 中出現一些相同命令序列，那麼我們可以為這些相同的命令序列定義成一個變數。定義這種命令序列的語法以 define 開始，以 endef 結束。
define run-yacc
yacc $(firstword $^)
mv y.tab.c [email protected]
endef
這裡 run-yacc 是這個命令包的名字，其不要和 Makefile 中的變數重名。在 define 和 endef 中的兩行就是命令序列。這個命令包中的第一個命令是執行 Yacc 程式，因為 Yacc 程式總是生成 y.tab.c 的檔案，所以第二行的命令就是把這個檔案改改名字。
foo.c : foo.y
$(run-yacc)
我們可以看見，要使用這個命令包，我們就好像使用變數一樣。在這個命令包的使用中，命令包 run-yacc 中的 $^ 就是 foo.y，[email protected] 就是 foo.c，make 在執行命令包時，命令包中的每個命令會被依次獨立執行。
Wordbook
GNU Compiler Collection，GCC：GNU 編譯器套件
GNU C Compiler，GCC：GNU C 編譯器
Microsoft Visual C++，MSVC
Unix / UNIX /ˈjuːnɪks/