make中的`docs`关键字是什么?为何自定义docs目标失效?
Make中
docs目标名触发“up to date”问题的原理与解决方法 核心原因
该问题并非因为docs是Make内置关键字,是GNU Make自带的隐式规则匹配逻辑导致的行为:
- GNU Make预装了一系列不需要手动定义就生效的隐式规则,覆盖常见文件的自动构建流程
- 其中一条预定义的文档构建隐式规则,专门用于匹配从Texinfo源文件生成Info格式文档的场景,规则的固定目标名就是
docs,对应流程是调用makeinfo工具将docs.texi源文件编译为docs格式的Info文档 - 由于你本地工作目录下本来就存在名为
docs的实体目录/文件(通常是存放项目文档的文件夹),Make在匹配到这条隐式规则后,会判断该同名实体文件已经存在、且没有更新的依赖文件需要同步,就会直接判定目标处于最新状态,跳过你在Makefile中自定义的docs目标执行逻辑。
改名后生效的原因
将目标名从docs改为doc后可以正常运行,是因为GNU Make的内置隐式规则中不存在对应doc的匹配逻辑,此时Make会直接读取你在Makefile中显式定义的目标规则,执行tfplugindocs命令。
规则的实现逻辑
可以通过命令验证这条内置规则的存在:
make -p | grep -B 2 -A 4 "docs\:"
输出的预定义规则片段逻辑为:
- 无显式定义时,
docs目标自动关联依赖源文件docs.texi - 检查当前路径下是否已存在
docs实体文件,若该文件修改时间晚于docs.texi,则直接跳过构建,输出“make: 'docs' is up to date.” - 仅当
docs.texi的修改时间晚于已存在的docs文件时,才会调用makeinfo命令执行编译流程。
正确使用建议
- 不需要刻意规避
docs作为目标名,只需要为该目标添加伪目标声明即可彻底避免误判:
添加声明后,Make会完全跳过所有针对.PHONY: docsdocs目标的隐式规则匹配,无论路径下是否存在同名的docs目录/文件,都会直接执行你自定义的构建逻辑。 - 若未添加
.PHONY伪目标声明,Make永远会优先匹配内置的隐式规则,再读取用户自定义的目标逻辑。
内容的提问来源于stack exchange,提问作者OJFord
相关产品推荐
相关产品推荐

