用途:为 Scenescape 项目提供统一的 Makefile 编写标准,规范构建目标、命名约定与常见模式,便于各服务与测试模块保持一致。
主要能力:定义目录结构(根 Makefile 编排、common.mk 共享逻辑、各服务独立 Makefile、tests 目录);变量命名约定(用户可配置用 UPPER_CASE 加 ?=,内部派生用 :=,命令输出用 $(shell ...));赋值运算符说明(?=、:=、=、+=);标准伪目标(build、clean、test、lint、install、help 等);目标模式(@ 静默、- 忽略错误、; 或 && 串联多行命令);依赖与仅顺序依赖、通配符依赖;并行构建与 .NOTPARALLEL;Docker 构建、Compose 操作与多阶段构建;测试目标(单元、功能、集成、覆盖率);清理与安装目标;自动生成帮助;前置条件与环境校验;反模式与性能建议。
使用方式:各服务 Makefile 通过 include ../common.mk 引入共享逻辑;常用命令如 make build、make test、make clean、make lint-all、make help;调试可用 make -n build、make build --debug=v、make print-VERSION。
适用场景:Scenescape 仓库内构建、测试、清理、Docker 镜像与 Compose 服务管理。
限制:资料未提供具体版本号、依赖清单或平台兼容性说明;部分命令依赖 Docker、docker compose、pytest、hadolint 等外部工具,需自行确保环境可用。