用途:当用户要求创建 Makefile、编写 Makefile、添加 make 目标或涉及 Makefile 约定时使用,帮助生成风格一致的 Makefile。
主要能力与约定:文件名使用 Makefile(首字母大写、无扩展名);第一行为 default: help;每个目标上方直接声明 .PHONY;目标行用单个 # 写说明,格式为 target: # Description;目标名小写、连字符分隔(如 test-e2e、type-check);复杂逻辑委托给脚本(如 ./scripts/build.sh),不内联。
自文档化 help 目标:通过 grep 解析带 # 注释的目标行,排序并彩色输出。每个目标必须有 # Description 注释,否则不会出现在 help 输出中。
常见目标:help(始终存在,显示可用目标)、init 或 setup(安装依赖、配置环境)、build(编译或打包)、dev(启动本地开发服务器)、test(运行测试套件)、lint(运行 linter 和格式化工具)。
限制与注意:Makefile 配方缩进必须使用字面制表符(tab),不能用空格;创建或修改 Makefile 后应提醒用户这一点。资料未提供其他平台、收费或效果信息。