【问题标题】:Secondary expansion in a Makefile is causing unnecessary targets to be runMakefile 中的二次扩展导致运行不必要的目标
【发布时间】:2025-11-22 09:35:01
【问题描述】:

我正在尝试使用 Latexmk 编写一个使用 LaTeX 构建 PDF 输出的 Makefile。输出具有基本相同的规则,具有不同的先决条件,因此我尝试使用 GNU Make 的“二次扩展”来概括我的原始 Makefile。 (我还创建了 .PHONY 目标,也具有二级扩展,以使其更加用户友好。)但是,这导致先决条件规则始终运行,即使它们不需要成为。好在 Latexmk 足够聪明,可以避免做不必要的工作,但不知道是不是我做错了什么……

尝试抽象我正在尝试的内容:

      ,-> foo -> build/foo.pdf
all -{
      `-> bar -> build/bar.pdf

all 目标构建foobar。这些目标打开各自的 PDF 文件,其先决条件为 build/X.pdf(其中 Xfoobar)。这些是构建适当 PDF 文件的真正目标。

这是我想出的:

TARGETS   = foo bar
BUILD_DIR = build
OUTPUTS   = $(TARGETS:%=$(BUILD_DIR)/%.pdf)

commonSRC = src/preamble.tex src/header.tex # etc...
fooSRC    = src/foo.tex $(commonSRC) # etc...
barSRC    = src/bar.tex $(commonSRC) # etc...

all: $(TARGETS)

.SECONDEXPANSION:
$(TARGETS): $(BUILD_DIR)/$$@.pdf
    open $<

# FIXME This isn't quite right: This rule is still getting called by the
# above rule, even when it doesn't need to be. Latexmk is clever enough
# not to do any extra work, but it shouldn't run at all.
.SECONDEXPANSION:
$(OUTPUTS): $$($$(subst .pdf,SRC,$$(@F))) $(BUILD_DIR)
    latexmk -outdir=$(BUILD_DIR) -auxdir=$(BUILD_DIR) -pdf $<

$(BUILD_DIR):
    mkdir $@

clean:
    rm -rf $(BUILD_DIR)

.PHONY: all $(TARGETS) clean

要明确一点:只要XSRC 中枚举的文件(同样,Xfoobar)比 PDF 更新,或者 PDF 不更新,build/X.pdf 的规则就应该运行不存在;但它不应该以其他方式运行。

【问题讨论】:

    标签: makefile gnu-make expansion indirection


    【解决方案1】:

    我认为这有点复杂,超出了它的需要。这些第二个扩展语句的一部分可以只替换为static pattern rules。另一件事是.SECONDEXPANSION: 使所有进一步的Makefile 内容受制于second expansion,因此您不需要在每个目标之前明确声明它(以这种方式标记.PHONY 目标会更清楚快速查看目标是否是假的)。

    尽管如此,我认为这里最重要的问题是您提到目录作为先决条件。请记住,make 决定是否根据依赖关系时间戳重建目标,并且每当更新此目录中的文件时,目录总是更新其时间戳。因此,每当您编写 $(BUILD_DIR)/foo.pdf 时,$(BUILD_DIR) 时间戳都会更新,并且由于目录较新,下一次调用将再次构建。您可以通过将目录指定为order-only prerequisite 来避免它(这意味着:如果它不存在则构建,但不要检查时间戳)。

    把它们放在一起,我会这样:

    TARGETS   = foo bar
    BUILD_DIR = build
    
    commonSRC = src/preamble.tex src/header.tex # etc...
    fooSRC    = src/foo.tex $(commonSRC) # etc...
    barSRC    = src/bar.tex $(commonSRC) # etc...
    
    .SECONDEXPANSION:
    
    .PHONY: all
    all: $(TARGETS)
    
    .PHONY: $(TARGETS)
    $(TARGETS): %: $(BUILD_DIR)/%.pdf
            echo open $<
    
    $(BUILD_DIR)/%.pdf: $$($$*SRC) | $(BUILD_DIR)
            echo latexmk -outdir=$(BUILD_DIR) -auxdir=$(BUILD_DIR) -pdf $< > $@
    
    $(BUILD_DIR):
            mkdir -p $@
    
    .PHONY: clean
    clean:
            rm -rf $(BUILD_DIR)
    

    输出:

    $ make all
    mkdir -p build
    echo latexmk -outdir=build -auxdir=build -pdf src/foo.tex > build/foo.pdf
    echo open build/foo.pdf
    open build/foo.pdf
    echo latexmk -outdir=build -auxdir=build -pdf src/bar.tex > build/bar.pdf
    echo open build/bar.pdf
    open build/bar.pdf
    
    $ make all
    echo open build/foo.pdf
    open build/foo.pdf
    echo open build/bar.pdf
    open build/bar.pdf
    

    请注意,随后的调用并未尝试构建任何内容,只需打开 pdf。但是,它仍然会对文件更改做出反应:

    $ touch src/foo.tex
    $ make all
    echo latexmk -outdir=build -auxdir=build -pdf src/foo.tex > build/foo.pdf
    echo open build/foo.pdf
    open build/foo.pdf
    echo open build/bar.pdf
    open build/bar.pdf
    
    $ touch src/header.tex
    $ make all
    echo latexmk -outdir=build -auxdir=build -pdf src/foo.tex > build/foo.pdf
    echo open build/foo.pdf
    open build/foo.pdf
    echo latexmk -outdir=build -auxdir=build -pdf src/bar.tex > build/bar.pdf
    echo open build/bar.pdf
    open build/bar.pdf
    

    【讨论】:

    • 谢谢 :) 除了“仅订购的先决条件”之外,我从未见过像 $(TARGETS): %: $(BUILD_DIR)/%.pdf 这样的规则,在目标和先决条件之间有一个额外的位。那叫什么,所以我可以在手册中阅读它?
    • 找到它:“静态模式规则”
    • 很高兴你找到了它。我在答案中链接了它。
    最近更新 更多