本章是對 make 執行過程中可能出現常見錯誤進行彙總、分析，並給出修正的可能方法。

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

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

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

[FOO] Error NN

[FOO] signal description

這類錯誤並不是 make 的真正的錯誤。它表示 make 所呼叫的程式返回非零的錯誤碼（ Error NN ），這種情況 make 會將其作為失敗處理、或者以非正常方式退出（攜帶某種訊號）。

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

missing separator. Stop.

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

不可識別的命令列， 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 什麼也不做。

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.

不正確的靜態模式規則。

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

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

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

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

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 採用正常的演算法來決定這些。當出現這種情況，子程序只會接受父程序傳遞的部分有用的資訊。子程序會產生該警告資訊，之後按照其內建的順序方式進行處理。