Makefile精读 · M01-02 | make 如何找到并执行 Makefile：`-f` `-C` 与默认文件名
模块：M01 心智模型与 make 入口
篇号：M01-02 / 41
预计阅读：30 分钟
主线：GNU Make
文章目录
- 本篇目标
- 30 秒速览
- 正文
- 1. 默认找谁：三种文件名，顺序固定
- 2. `-f`：我指定读这份
- 3. `-C`：先换目录，再找 Makefile
- 4. 工作目录决定相对路径落在哪
- 5. 多目录仓库：如何快速锁定「入口」
- 6. 对照表：本篇选项与概念
- 读 Makefile 检查清单
- 练习
- 判断题（对 / 错）
- 改错题
- 动手题
- 下一篇预告
本篇目标
搞清一件「看似简单、工程里却常踩坑」的事：你敲下make时，程序到底读了哪一份文件、在哪个目录当工作目录。掌握默认文件名顺序、-f、-C，以及它们如何组合。学完本篇，你在多目录仓库根目录执行make，能立刻定位真正的入口 Makefile，而不是「为什么改了文件却没生效」。
30 秒速览
- 未指定
-f时，GNU Make 在当前工作目录按顺序找：GNUmakefile→makefile→Makefile，用第一个找到的。 -f FILE：显式指定读哪份文件；可写相对/绝对路径，可指定多次（少见）。-C DIR（或--directory=DIR）：先chdir到DIR，再按上面规则找 Makefile（或再配合-f）。- 配方里的相对路径、生成文件落点，都相对make 进程的工作目录（受
-C影响），不是「Makefile 文件所在目录」的魔法自动切换——除非你用-C或配方里自己cd。 - 读大型工程：先确认文档要求你在哪一级目录执行，再用
make -p/ 看仓库根是否有入口Makefile。
正文
1. 默认找谁：三种文件名，顺序固定
在某个目录执行裸命令：
$makeGNU Make不会全盘搜索仓库，只在当前工作目录查找，顺序为：
| 优先级 | 文件名 | 常见用途 |
|---|---|---|
| 1 | GNUmakefile | 明确只给 GNU Make 用（其它 make 通常不认这个名） |
| 2 | makefile | 全小写；部分项目偏好 |
| 3 | Makefile | 最常见；许多风格指南推荐这个 |
规则：
- 找到第一个存在的文件就用它，不会把三个都读一遍再合并。
- 若三个都不存在，报错类似：
make: *** No targets specified and no makefile found. Stop.（具体文案随版本略有差异）。
实践建议（本专栏约定）：
- 自己写工程时，优先用
Makefile（首字母大写），和多数开源 C/C++ 项目一致。 - 只有在「必须排除非 GNU make」时才考虑
GNUmakefile。 - 避免在同一目录同时放
makefile与Makefile——在大小写不敏感的文件系统（如默认的 macOS）上极易混淆。
对照实验（在空目录）：
$echo'all:; @echo from-Makefile'>Makefile $makefrom-Makefile $echo'all:; @echo from-gnu'>GNUmakefile $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--file=Makefilemake--makefile=Makefile与-f等价。
读文档检查点：若 README 写的是make -f ...，不要省略-f直接make——你可能读到另一份默认文件，行为完全不同。
3.-C：先换目录，再找 Makefile
make-Csubdirmake--directory=subdir等价于：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去构建子树（递归 Make，M08-02 详讲）。 - 你在仓库根目录，却想只构建某个子项目：
make -C tools/foo。
与「自己 cd 再 make」对照：
cdbuild&&make# 大致相当于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 DIR | DIR | DIR |
make -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-d2>&1|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和Makefile，GNU 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 时能第一眼抓住「默认构建什么、清理什么」。