Makefile精读 · M01-02 | make 如何找到并执行 Makefile：`-f` `-C` 与默认文件名

模块M01 心智模型与 make 入口篇号M01-02 / 41预计阅读30 分钟主线GNU Make文章目录本篇目标30 秒速览正文1. 默认找谁三种文件名顺序固定2. -f我指定读这份3. -C先换目录再找 Makefile4. 工作目录决定相对路径落在哪5. 多目录仓库如何快速锁定「入口」6. 对照表本篇选项与概念读 Makefile 检查清单练习判断题对 / 错改错题动手题下一篇预告本篇目标搞清一件「看似简单、工程里却常踩坑」的事你敲下make时程序到底读了哪一份文件、在哪个目录当工作目录。掌握默认文件名顺序、-f、-C以及它们如何组合。学完本篇你在多目录仓库根目录执行make能立刻定位真正的入口 Makefile而不是「为什么改了文件却没生效」。30 秒速览未指定-f时GNU Make 在当前工作目录按顺序找GNUmakefile→makefile→Makefile用第一个找到的。-f FILE显式指定读哪份文件可写相对/绝对路径可指定多次少见。-C DIR或--directoryDIR先chdir到DIR再按上面规则找 Makefile或再配合-f。配方里的相对路径、生成文件落点都相对make 进程的工作目录受-C影响不是「Makefile 文件所在目录」的魔法自动切换——除非你用-C或配方里自己cd。读大型工程先确认文档要求你在哪一级目录执行再用make -p/ 看仓库根是否有入口Makefile。正文1. 默认找谁三种文件名顺序固定在某个目录执行裸命令$makeGNU Make不会全盘搜索仓库只在当前工作目录查找顺序为优先级文件名常见用途1GNUmakefile明确只给 GNU Make 用其它 make 通常不认这个名2makefile全小写部分项目偏好3Makefile最常见许多风格指南推荐这个规则找到第一个存在的文件就用它不会把三个都读一遍再合并。若三个都不存在报错类似make: *** No targets specified and no makefile found. Stop.具体文案随版本略有差异。实践建议本专栏约定自己写工程时优先用Makefile首字母大写和多数开源 C/C 项目一致。只有在「必须排除非 GNU make」时才考虑GNUmakefile。避免在同一目录同时放makefile与Makefile——在大小写不敏感的文件系统如默认的 macOS上极易混淆。对照实验在空目录$echoall:; echo from-MakefileMakefile $makefrom-Makefile $echoall:; echo from-gnuGNUmakefile $makefrom-gnu一旦出现GNUmakefile同目录的Makefile会被盖过。这是读他人项目时的高频坑你改了Makefile实际生效的却是GNUmakefile。2.-f我指定读这份make-fpath/to/rules.mkmake-fbuild/Makefile含义不要再按默认三文件名去猜对该次指定而言以-f为准。path/to/rules.mk可以是任意名字rules.mk、project.make、Android.mk仅作文件名举例都行。路径是相对当前工作目录解析的若同时用了-C见下一节。常见场景场景示例一份文件多种构建配置make -f Makefile.debug子目录里的片段当入口试跑make -f src/module/rules.mk文档明确写了非默认名make -f GNUmakefile.custom也可以写成make--fileMakefilemake--makefileMakefile与-f等价。读文档检查点若 README 写的是make -f ...不要省略-f直接make——你可能读到另一份默认文件行为完全不同。3.-C先换目录再找 Makefilemake-Csubdirmake--directorysubdir等价于make 先切换到subdir再在该目录按默认名或你再给的-f读取并构建。示意你在: /home/you/proj 执行: make -C build make 的工作目录变成: /home/you/proj/build 然后在 build/ 下找 GNUmakefile / makefile / Makefile组合# 进入 build/并明确读该目录下的 rules.mkmake-Cbuild-frules.mk# 进入 build/用绝对路径指定文件少见但合法make-Cbuild-f/home/you/proj/top.mk为何工程里大量用-C顶层Makefile常写$(MAKE) -C src去构建子树递归 MakeM08-02 详讲。你在仓库根目录却想只构建某个子项目make -C tools/foo。与「自己 cd 再 make」对照cdbuildmake# 大致相当于make-Cbuild差别在于-C由 make 自己切换目录且可以和其它选项干净组合脚本里更不容易写错「cd 之后忘了回来」。4. 工作目录决定相对路径落在哪这是本篇最容易忽略的一点。假设仓库布局proj/ Makefile # 入口 src/hello.c build/ # 希望产物放这里若Makefile在proj/且你在proj/执行make配方里写build/hello: src/hello.c gcc -o build/hello src/hello.c这里的src/hello.c、build/hello都相对proj/当前工作目录。若有人习惯cdsrcmake-f../Makefile则工作目录是src/同一份 Makefile 里的相对路径src/hello.c会变成去找src/src/hello.c——路径全错。此时更稳妥的是make-C..-fMakefile# 或在 proj/ 下直接make经验法则做法工作目录相对路径相对于在含 Makefile 的目录执行make该目录该目录make -C DIRDIRDIRmake -f other/dir/Makefile无-C你仍在的当前目录当前目录不是 Makefile 所在目录第三行尤其重要-f只指定读哪个文件默认不改变工作目录。5. 多目录仓库如何快速锁定「入口」读陌生项目时建议按这个顺序看文档README / 构建说明要求在哪一级目录执行是否写了-f/-C看仓库根有没有Makefile/GNUmakefile打开看默认目标是什么M01-03有没有include子文件或$(MAKE) -C ...。用搜索辅助但别盲信文件名很多*/Makefile是子目录片段不是你该直接make的入口。验证在文档指定的目录执行make -n只打印将执行的命令不真正跑M01-04 / M09 还会用到看路径是否合理。可选自检命令在你认为的入口目录# 看 make 认为自己在读什么调试输出里会提到 Reading makefiles...make-d21|head-n40更干净的做法是看内置变量M03 会系统讲变量这里先作工具用make-p-f/dev/null2/dev/null|head-n5# 仅演示 -p日常更常用下面方式日常推荐在入口目录make-n若输出的命令路径明显「高一层 / 低一层」说明工作目录或入口选错了。6. 对照表本篇选项与概念项作用GNUmakefile默认查找优先级最高makefile其次Makefile再次本专栏推荐自用名-f FILE/--file显式指定 Makefile不改工作目录-C DIR/--directory先进入DIR再构建工作目录解析相对路径、默认找文件名所在的「当前目录」入口 Makefile文档或仓库根约定的、你应该启动的那一份常见组合记忆make# 当前目录 默认文件名make-frules.mk# 当前目录 指定文件make-Cbuild# build/ 默认文件名make-Cbuild-frules.mk读 Makefile 检查清单接到一个「去跑一下构建」的任务时文档要求的工作目录是哪一级你现在是否在那一级该目录下是否同时存在GNUmakefile与Makefile若是默认生效的是前者命令是否带-f/-C两者含义是否分清指定文件 vs 换目录你改的那份文件是不是 make实际读取的那份配方里的相对路径是相对「当前工作目录」还是有人误以为相对「Makefile 所在目录」练习判断题对 / 错同一目录下若同时有GNUmakefile和MakefileGNU Make 默认会合并二者再执行。make -f build/Makefile会自动把工作目录改成build/。make -C build会先进入build/再按默认文件名查找。本专栏推荐日常新建工程使用文件名Makefile。参考答案错。只用第一个找到的顺序是GNUmakefile→makefile→Makefile。错。-f不改变工作目录相对路径仍相对你执行命令时所在目录。对。对。改错题某仓库结构如下proj/ Makefile # 内含hello: src/hello.c 与配方 gcc -o hello src/hello.c src/hello.c同事在proj/src/下执行make-f../Makefile结果找不到src/hello.c。为什么如何改命令更合理参考答案原因-f ../Makefile只指定读上层文件工作目录仍是proj/src/于是去打开proj/src/src/hello.c。更合理cd/path/to/projmake# 或在任意处make-C/path/to/proj动手题在临时目录创建Makefile再创建GNUmakefile确认make打印的是后者规则。用make -C ...在上一级目录触发子目录构建观察生成文件出现在哪。故意使用make -f sub/Makefile不-C体会相对路径错位。下一篇预告M01-03《默认目标、.PHONY与all/clean约定》— 不带目标名时 make 构建谁、为何clean必须做成伪目标、以及社区常见的all/install/test命名习惯。学完 M01-03你读入口 Makefile 时能第一眼抓住「默认构建什么、清理什么」。