Makefile 中 .PHONY 的用途是什么？

Question

Makefile 中的 .PHONY 是什么意思？我已经经历过这个，但它太复杂了。

有人可以用简单的语言向我解释一下吗？

Answer 1

默认情况下，Makefile 目标是“文件目标”——它们用于从其他文件构建文件。 Make 假定其目标是一个文件，这使得编写 Makefile 相对容易：

foo: bar
  create_one_from_the_other foo bar

但是，有时，您希望 Makefile 运行不代表文件系统中的物理文件的命令。很好的例子是共同目标“干净”和“全部”。情况可能并非如此，但您的主目录中可能可能有一个名为clean的文件。在这种情况下，Make 会感到困惑，因为默认情况下，clean 目标将与此文件关联，并且 Make 仅当该文件在以下方面似乎不是最新时才运行它：它的依赖项。

这些特殊目标称为假目标，您可以明确告诉 Make 它们与文件无关，例如：

.PHONY: clean
clean:
  rm -rf *.o

现在，即使您确实有文件，make clean 也会按预期运行名为clean。

就 Make 而言，虚假目标只是一个始终过时的目标，因此每当您询问 make 时，它都会运行，独立于文件系统的状态。一些常见的 make 目标通常是假的：all、install、clean、distclean代码>、<代码>标签、<代码>信息、<代码>检查。

另请参阅：GNU make 手册：假目标

Answer 2

假设您有 install 目标，这在 makefile 中非常常见。如果您不使用.PHONY，并且名为install的文件与Makefile位于同一目录中，则make install< /code> 将什么都不做。这是因为 Make 将规则解释为“执行某某配方以创建名为 install 的文件”。由于该文件已经存在，并且其依赖项没有更改，因此不会执行任何操作。

但是，如果您将 install 目标设置为 PHONY，它将告诉 make 工具该目标是虚构的，并且 make 不应期望它创建实际文件。因此，它不会检查 install 文件是否存在，这意味着：a) 如果文件确实存在，则其行为不会改变，b) 额外的 stat() 不会被改变叫。

通常，Makefile 中不生成与目标名称同名的输出文件的所有目标都应该是 PHONY。这通常包括all、install、clean、distclean等。

Answer 3

注意：make 工具读取makefile 并检查规则中':' 符号两侧的文件的修改时间戳。

示例

在目录“test”中存在以下文件：

prerit@vvdn105:~/test$ ls
hello  hello.c  makefile

在 makefile 中，规则定义如下：

hello:hello.c
    cc hello.c -o hello

现在假设文件“hello”是包含一些数据的文本文件，该文件是在“hello.c”文件之后创建的。因此“hello”的修改（或创建）时间戳将比“hello.c”的更新。因此，当我们从命令行调用“make hello”时，它将打印为：

make: `hello' is up to date.

现在访问“hello.c”文件并在其中添加一些空格，这不会影响代码语法或逻辑，然后保存并退出。现在 hello.c 的修改时间戳比 'hello' 的修改时间戳更新。现在，如果您调用“make hello”，它将执行以下命令：

cc hello.c -o hello

并且文件“hello”（文本文件）将被新的二进制文件“hello”（上述编译命令的结果）覆盖。

如果我们在 makefile 中使用 .PHONY，如下所示：

.PHONY:hello

hello:hello.c
    cc hello.c -o hello

然后调用“make hello”，它将忽略 pwd“test”中存在的任何文件并每次执行该命令。

现在假设“hello”目标没有声明依赖项：

hello:
    cc hello.c -o hello

并且“hello”文件已存在于 pwd“test”中，那么“make hello”将始终显示为：

make: `hello' is up to date.

Answer 4

.PHONY: install

• 意味着“安装”一词不代表此文件名
  生成文件；
• 表示 Makefile 与名为“install”的文件无关
  在同一目录中。

Answer 5

它是一个构建目标，而不是文件名。

Answer 6

特殊目标 .PHONY: 允许声明虚假目标，以便 make 不会将它们检查为实际文件名：即使此类文件仍然存在，它也会一直工作。

您可以在 Makefile 中放置多个 .PHONY: ：

.PHONY: all

all : prog1 prog2

...

.PHONY: clean distclean

clean :
    ...
distclean :
    ...

还有另一种声明虚假目标的方法：只需放置 :: 而无需先决条件：

all :: prog1 prog2

...

clean ::
    ...
distclean ::
    ...

< code>:: 有其他特殊含义，请参见此处，但如果没有先决条件，它总是执行配方，即使目标已经存在，从而充当虚假目标。

Answer 7

最好的解释是 GNU make 手册本身：4.6 Phony Targets 部分< /a>.

.PHONY 是 make 的 特殊的内置目标名称。您可能还对其他目标感兴趣，因此值得浏览一下这些参考资料。

当需要考虑 .PHONY 目标时，make 将运行其配方
无条件地，无论具有该名称的文件是否存在或
它的最后修改时间是多少。

您可能还对 make 的 标准目标 感兴趣，例如全部和干净。

Answer 8

“.PHONY”还有一个重要的棘手问题 - 当一个物理目标依赖于另一个物理目标的虚假目标时：

TARGET1 -> TARGET1 -> PHONY_FORWARDER1 -> PHONY_FORWARDER2 -> TARGET2

您可能只是希望，如果您更新了 TARGET2，那么 TARGET1 应被视为相对于 TARGET1 而言已过时，因此应重建 TARGET1。 它确实是这样工作的。

棘手的部分是 TARGET2 对于 TARGET1 不是 过时的 - 在这种情况下，您应该期望 TARGET1 不应该被重建。

令人惊讶的是，这不起作用，因为：虚假目标无论如何都会运行（就像虚假目标通常所做的那样），这意味着虚假目标被视为已更新。因此，TARGET1 对于虚假目标来说被认为是过时的。

考虑一下：

all: fileall

fileall: file2 filefwd
    echo file2 file1 >fileall


file2: file2.src
    echo file2.src >file2

file1: file1.src
    echo file1.src >file1
    echo file1.src >>file1

.PHONY: filefwd
.PHONY: filefwd2

filefwd: filefwd2

filefwd2: file1
    @echo "Produced target file1"


prepare:
    echo "Some text 1" >> file1.src
    echo "Some text 2" >> file2.src

您可以尝试一下：

• 首先执行“makeprepare”来准备“源文件”，
• 然后通过触摸特定文件来查看它们的更新

您可以看到 fileall 通过虚假目标间接依赖于 file1 - 但它由于这种依赖性，总是会被重建。如果将 fileall 中的依赖项从 filefwd 更改为 file，现在 fileall 不会每次都重新构建，而是仅当任何依赖目标作为文件对其而言已过时时。

Answer 9

因此，假设运行 make 的目录中有一个名为“clean”的文件。现在让我们以下面的 Makefile 为例：

clean:
        rm lol

现在，当您运行“make clean”时，您将得到以下输出：

但是如果您将“.PHONY: clean”添加到 Makefile 并运行“make clean”，您将看到以下输出

发生了什么？
由于目录中存在文件，所以第一次将 clean 视为目标。
但添加 .PHONY 后，make 会忽略该文件（以及时间戳跟踪）并将其解释为正常干净。

现在，这可以应用于许多情况，您希望 make 忽略作为目标给出的参数（当您在该目录中具有相同名称的文件时）。

Answer 10

我经常用它们来告诉默认目标不要开火。

superclean: clean andsomethingelse

blah: superclean

clean:
   @echo clean

%:
   @echo catcher $@

.PHONY: superclean

如果没有 PHONY，make superclean 将触发 clean、andsomethingelse 和 catcher superclean；但对于 PHONY，make superclean 不会触发 catcher superclean。

我们不必担心告诉 make clean 目标是假的，因为它并不完全是假的。虽然它永远不会生成干净的文件，但它有要触发的命令，因此 make 会认为它是最终目标。

然而，superclean 目标确实是假的，因此 make 会尝试将其与为 superclean 目标提供 deps 的任何其他内容堆叠在一起 - 这包括其他 superclean< /code> 目标和 % 目标。

请注意，我们根本没有说任何有关 andsomethingelse 或 blah 的内容，因此它们显然去了捕手。

输出看起来像这样：

$ make clean
clean

$ make superclean
clean
catcher andsomethingelse

$ make blah 
clean
catcher andsomethingelse
catcher blah

Answer 11

这样

.PHONY: clean
clean:
        rm *.o temp

，即使工作区中有 clean file，您仍然可以在代码中执行 clean 目标