make的常見錯誤資訊 

本內容對make執行時可能出現常見錯誤進行匯總、分析，並給出修正的可能方法。

make執行過程中所產生錯誤並不都是致命的；特別是在命令行之前存在“-”、或者make使用“-k”選項執行時。make執行過程的致命錯誤都帶有首碼字串“***”。

錯誤資訊都有首碼，一種是執行程式名作為錯誤首碼（通常是“make”）；另外一種是當Makefile本身存在語法錯誤無法被make解析並執行時，首碼包含了makefile檔案名和出現錯誤的行號。

在下述的錯誤列表中，省略了普通首碼：

[FOO] Error NN

[FOO] signal description

這類錯誤並不是make的真正錯誤。它表示make檢測到make所調用的作為執行命令的程式返回一個非零狀態（Error NN），或者此命令程式以非正常方式退出（攜帶某種信號），參考 5.4 命令的錯誤 一節。

如果錯誤資訊中沒有附加“***”字串，則是子過程的調用失敗，如果Makefile中此命令有首碼“-”，make會忽略這個錯誤。

missing separator. Stop.

missing separator (did you mean TAB instead of 8 spaces?). Stop.

不可識別的命令行，make在讀取Makefile過程中不能解析其中包含的內容。GNU make在讀取Makefile時根據各種分隔符號（:, =, [TAB]字元等）來識別Makefile的每一行內容。這些錯誤意味著make不能發現一個合法的分隔符號。

出現這些錯誤資訊的可能的原因是（或許是編輯器，絕大部分是ms-windows的編輯器）在Makefile中的命令之前使用了4個（或者8個）空格代替了[Tab]字元。這種情況，將產生上述的第二種形式產生錯誤資訊。且記，所有的命令行都應該是以[Tab]字元開始的。

commands commence before first target. Stop.

missing rule before commands. Stop.

Makefile可能是以命令行開始：以[Tab]字元開始，但不是一個合法的命令行（例如，一個變數的賦值）。命令行必須和規則一一對應。

產生第二種的錯誤的原因可能是一行的第一個非空字元為分號，make會認為此處遺漏了規則的“target: prerequisite”部分。

No rule to make target `XXX'.

No rule to make target ` XXX ', needed by `yyy'.

無法為重建目標“XXX”找到合適的規則，包括明確規則和隱含規則。

修正這個錯誤的方法是：在Makefile中添加一個重建目標的規則。其他可能導致這些錯誤的原因是Makefile中檔案名拼寫錯誤，或者破壞了原始檔案樹（一個檔不能被重建，可能是由於依賴檔的問題）。

No targets specified and no makefile found. Stop.

No targets. Stop.

第一個錯誤表示在命令行中沒有指定需要重建的目標，並且make不能讀入任何makefile檔。第二個錯誤表示能夠找到makefile檔，但沒有終極目標或者沒有在命令行中指出需要重建的目標。這種情況下，make什麼也不做。參考 第九章 執行make

Makefile `XXX' was not found.

Included makefile `XXX' was not found.

沒有使用“-f”指定makefile檔，make不能在當前目錄下找到默認Makefile（makefile或者GNUmakefile）。使用“-f”指定檔，但不能讀取這個指定的makefile檔。

warning: overriding commands for target `XXX'

warning: ignoring old commands for target `XXX'

對同一目標“XXX”存在一個以上的重建命令。GNU make規定：當同一個檔作為多個規則的目標時，只能有一個規則定義重建它的命令（雙冒號規則除外）。如果為一個目標多次指定了相同或者不同的命令，就會產生第一個告警；第二個告警資訊說新指定的命令覆蓋了上一次指定的命令。

Circular XXX <- YYY dependency dropped.

規則的依賴關係產生了迴圈：目標“XXX”的依賴檔為“YYY”，而依賴“YYY”的依賴列表中又包含“XXX”。

Recursive variable `XXX' references itself (eventually). Stop.

make的變數“XXX”（遞迴展開式）在替換展開時，引用它自身。無論對於直接展開式變數（通過:=定義的）或追加定義（+=），這都是不允許的。

Unterminated variable reference. Stop.

變數或者函數引用語法不正確，沒有使用完整的的括弧（缺少左括弧或者右括弧）。

insufficient arguments to function `XXX'. Stop.

函數“XXX”引用時參數數目不正確。函數缺少參數。

missing target pattern. Stop.

multiple target patterns. Stop.

target pattern contains no `%'. Stop.

mixed implicit and static pattern rules.  Stop.

不正確的靜態模式規則。

第一條錯誤的原因是：靜態模式規則的目標段中沒有模式目標；

第二條錯誤的原因是：靜態模式規則的目標段中存在多個模式目標；

第三條錯誤的原因是：靜態模式規則的目標段目標模式中沒有包含模式字元“%”；

第四條錯誤的原因是：靜態模式規則的三部分都包含了模式字元“%”。正確的應該是只有後兩個才可以包含模式字元“%”。

關於靜態模式規則可參考 4.12 靜態模式 一節

warning: -jN forced in submake: disabling jobserver mode.

這一條告警和下條告警資訊發生在：make檢測到遞迴的make調用時，可通信的子make進程出現並行處理的錯誤。遞迴執行的make的命令行參數中存在“-jN”參數（N的值大於1），在有些情況下可能導致此錯誤，例如：Makefile中變數“MAKE”被賦值為“make –j2”，並且遞迴調用的命令行中使用變數“MAKE”。在這種情況下，被調用make進程不能和其他make進程進行通信，其只能簡單的獨立的並行處理兩個任務”。

warning: jobserver unavailable: using -j1. Add `+' to parent make rule.

為了現實make進程之間的通信，上層make進程將傳遞資訊給子make進程。在傳遞資訊過程中可能存在這種情況，子make進程不是一個實際的make進程，而上層make卻不能確定子進程是否是真實的make進程。它只是將所有資訊傳遞下去。上層make採用正常的演算法來決定這些。當出現這種情況，子進程只會接受父進程傳遞的部分有用的資訊。子進程會產生該警告資訊，之後按照其內建的順序方式進行處理。

引用:http://www.linuxsir.org/main/doc/gnumake/GNUmake_v3.80-zh_CN_html/make-15.html