Makefile 生成器
目标一次勾齐,缩进不会再写成空格
如何使用本工具
- 先选项目类型,目标清单和命令模板会跟着换,省得自己对着文档抄。
- 勾要用的目标,填应用名和端口。变量会用 ?= 定义,命令行可以直接环境变量覆盖。
- 复制生成结果存成 Makefile。命令行已经是 Tab 缩进,不用再处理。
- 有现成的 Makefile 就粘到左下角做检查:空格缩进、缺 .PHONY、目标重名一次全找出来。
- 跑 make help 看目标清单,再 make <目标> 单独执行。
常见问题
Q:为什么 make 报 missing separator?
A:命令行不是以 Tab 开头。make 只认 Tab(0x09),四个空格看起来一样但它不认,而且报错只给行号不给原因,所以这是 make 的第一号坑。编辑器里建议打开「显示空白字符」,并把 Makefile 的缩进模式设成硬 Tab。第二号坑是编辑器自动把 Tab 转成空格,保存一次就全毁了。
Q:.PHONY 到底有什么用?
A:声明这个目标是「假的」,永远执行,不检查同名文件的时间戳。如果不写 .PHONY,而目录里恰好有个叫 test 的文件,make test 会输出 make: 'test' is up to date. 然后什么都不做——这种 bug 很难发现,因为不报错。另外 .PHONY 还有个附带好处:声明后 make 会跳过对同名文件的隐式规则搜索,速度略快。
Q:变量里 ?= 和 = 和 := 有什么区别?
A:= 是递归展开,赋值时不求值,用到时才展开,所以可以引用后面才定义的变量;:= 是立即展开,赋值那一刻就定死;?= 是「没定义过才赋值」。写 Makefile 一般用 := 更可预测,但配置类变量(APP、PORT、TAG)用 ?= 才能让命令行和环境变量覆盖:make PORT=9000 优先级高于文件里的定义。
Q:命令前面加 @ 是什么意思?
A:不打印这条命令本身,只显示它的输出。make 默认会把每条命令 echo 一遍,加上 @ 让日志干净。想整份静默就 make -s,或者给目标加 .SILENT。反过来,make -n 只打印不执行,用来核对命令拼得对不对。
Q:$(APP) 和 $APP 有什么区别?
A:make 只认 $(...) 或 ${...},$APP 会被当成变量 A 后面跟着字符串 PP。另外 $ 在 recipe 里传给 shell 之前要先转义成 $$,所以 shell 自己的变量要写 $$i,awk 的字段要写 $$1——漏一个就变成 make 变量,展开成空字符串,然后 shell 报语法错。
Q:为什么 clean 目标写成 rm -rf 有风险?
A:如果变量没定义,rm -rf $(BUILD_DIR) 会退化成 rm -rf,把当前目录清空。防御写法是 $(RM) -r -- $(BUILD_DIR) 并且加个前置检查,或者用 .DELETE_ON_ERROR 配合明确的路径。更稳的是给每个路径加前缀,绝不在 clean 里用通配符裸奔。
Q:help 目标是怎么自动列出所有目标的?
A:靠约定:每个目标行末尾用 ## 写一句说明,help 目标用 grep 抓 ^目标名:.*?## .*$ 这种行,再用 awk 按 :.*?## 切分字段打印。所以说明必须写在同一行的 ## 后面,写在下一行就抓不到。这是 make 社区很通行的写法,零依赖。
Q:dry-run 怎么写才安全?
A:用 make -n 先看要执行什么,确认路径都展开成绝对值再跑。涉及删除、上传、部署的目标建议再加一层:if [ -z "$(APP)" ]; then exit 1; fi 这种空值守卫,让它在变量没传时直接失败,而不是带着空参数一路执行下去。