当前位置:首页 > 技术 > 正文内容

Makefile 中 .PHONY 的作用与必要性

访客 技术 2026年7月8日 1

在 Makefile 中,"伪目标"(Phony Target)是一个并不对应实际文件名的标签。执行 make 时可以指定这个标签来运行其下定义的命令,它也可以看作是一个"标记"。通过 .PHONY 来声明伪目标,可以确保其命令总是被执行,无需担心与文件重名或缓存问题。

为什么需要 .PHONY?

假如我们想通过 Makefile 执行一些清理工作,例如:

clean:
        rm *.o temp

执行 make clean 时,期望运行 rm *.o temp。但如果当前目录下恰好也存在一个名为 "clean" 的文件,Make 会认为该目标已是最新,而不会执行任何命令,这样就达不到预期效果。

解决方式是将目标声明为伪目标:

.PHONY: clean
clean:
        rm *.o temp

这样,无论是否存在同名文件,make clean 都会强制执行对应的命令。而且,由于 Make 不再尝试查找 clean 的隐含规则,执行效率也会有所提升。

确保源文件变更后自动重建

在多层目录的项目中,如果不使用 .PHONY 声明中间目标,会导致源文件修改后无法触发重新编译。以下是一个试验场景:

项目结构如下(/work 目录):

  • test/:包含 test.c 和子 Makefile
  • add/:包含 add.c 和子 Makefile
  • sub/:包含 sub.c 和子 Makefile
  • include/:包含 heads.h

各子目录 Makefile 示例(以 test 为例):

test.o: test.c ../include/heads.h
        gcc -c -o $@ $<

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

顶层 Makefile:

OBJS = ./add/add.o ./sub/sub.o ./test/test.o

program: $(OBJS)
        gcc ./test/test.o ./add/add.o ./sub/sub.o -o program

$(OBJS):
        make -C $(dir $@)

.PHONY: clean
clean:
        make -C ./add clean
        make -C ./sub clean
        make -C ./test clean
        rm -f program

首次执行 make 能成功生成 program。但当修改 test.c 后再次执行 make,控制台显示:

make: `program' is up to date.

目标文件 test.o 并未重建,导致最终可执行文件没有更新。这是因为 program 直接依赖的是 *.o 文件,而非源文件。Make 在检查时,只会比较 program*.o 的时间戳。由于 *.oprogram 旧,故认为 program 已是最新。

解决方案:$(OBJS) 声明为伪目标,强制 Make 每次都执行其规则:

OBJS = ./add/add.o ./sub/sub.o ./test/test.o

program: $(OBJS)
        gcc ./test/test.o ./add/add.o ./sub/sub.o -o program

.PHONY: $(OBJS)
$(OBJS):
        make -C $(dir $@)

.PHONY: clean
clean:
        make -C ./add clean
        make -C ./sub clean
        make -C ./test clean
        rm -f program

添加 .PHONY: $(OBJS) 后,Make 不再将 ./add/add.o 等视为普通文件目标,而是强制进入子目录执行 make。子目录的 Makefile 会正确比较 *.cheads.h*.o 的时间戳,若源文件更新则重建目标文件。返回顶层后,再链接生成最终的 program

原理: 在未声明伪目标时,顶层 Makefile 将 *.o 当作文件依赖,仅检查它们与 program 的新旧关系。而源文件是间接依赖,不会被检查。通过 .PHONY 声明后,Make 不再比较时间戳,直接执行规则,从而让子目录的构建逻辑生效。

总结

.PHONY 伪目标能够解决"源文件并非最终目标的直接依赖"而导致的自动更新失效问题。它强制 Make 执行指定规则,不受文件名冲突或缓存的影响,确保构建流程的正确性。

相关文章

Linux crontab 详解

1) crontab 是什么cron 是 Linux 的定时任务守护进程;crontab 是用来编辑/查看“按时间周期执行命令”的表(cron table)。常见两类:用户 crontab:每个用户一份(crontab -e 编辑)系统级 crontab / cron.d:可指定执行用户(/etc/crontab、/etc/cron.d/*)2) crontab 时间...

富文本里可以允许的 HTML 属性

一、所有标签默认允许的安全属性(极少)class        (可选)id           (通常建议禁用)title️ 注意:id 容易被滥用做锚点注入,很多系统直接禁用class 允许的话最好只允许固定前缀(如 editor-*)二、a 标签允许属性<a href="" t...

Mac 安装 Node.js 指南

方法一:通过官网安装包(最简单,适合初学者)如果你只是想快速安装并开始使用,这是最直接的方法。访问 Node.js 官网。页面会显示两个版本:LTS (Recommended For Most Users):长期支持版,最稳定。建议选这个。Current:最新特性版,包含最新功能但可能不够稳定。下载 .pkg 安装包并运行。按照安装向导点击“下一步”即可完成。方法二:使用 Homebrew 安装(...

Dom\HTML_NO_DEFAULT_NS 的副作用:自动加闭合标签

在使用Dom\HTMLDocument时,Dom\HTML_NO_DEFAULT_NS 将禁止在解析过程中设置元素的命名空间, 此设置是为了与DOMDocument向后兼容而存在的。当使用它时,已知的一个副作用就是:自动加闭合标签例如 </img> 为什么会这样?当你使用:Dom\HTML_NO_DEFAULT_NS文档会变成 无命名空间模式,此时内部更接近 XML...

Laravel 事件和监听器创建

在 Laravel 中,使用 Artisan 命令创建 Events(事件) 和 Listeners(监听器) 是非常高效的。你可以通过以下几种方式来实现:1. 手动创建单个 Event如果你只想创建一个事件类,可以使用 make:event 命令:Bashphp artisan make:event UserRegistered执行后,文件将生成在 app/Even...

自定义域名解析神器 dnsmasq

什么是 dnsmasq?dnsmasq 是一个轻量级、功能强大的网络服务工具,专为小型和中等规模网络设计。它是一个综合的网络基础设施解决方案[1]。dnsmasq 能做什么?功能说明应用场景DNS 转发与缓存将 DNS 查询转发到上游服务器(ISP、Google DNS 等),并在本地缓存结果加快 DNS 查询速度,减少外部 DNS 流量本地 DNS解析本地网络设备的主机名,无需编辑&n...

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。