Makefile中正确传递参数给容器内Python脚本

Make 不支持将额外参数直接作为目标传入（例如 make deploy arg1 arg2），因为所有命令行词元均被解析为目标或变量赋值；正确的做法是通过环境变量（如 DEPLOY_ARGS）传递参数，再在规则中引用。

在容器化部署流程中，经常需要向容器内的脚本传递运行时参数，例如执行 python3 deploy.py server project。很多人习惯直接用 make deploy server project，结果会遇到错误：make: *** No rule to make target 'server'. Stop. 原因很简单：Make 将 server 和 project 视为独立的目标，而非 deploy 的参数。这是 Make 设计上的一个“边界”：所有命令行词元要么是目标，要么是变量赋值，没有第三条路。

正确的做法：通过变量传递参数

改造思路很直接——在 Makefile 中定义一个可被覆盖的变量（例如 DEPLOY_ARGS），然后在命令中引用它：

.PHONY: deploy
DEPLOY_ARGS =
deploy:
    @docker exec -it ecosystem python3 deployment/deploy.py $(DEPLOY_ARGS)

调用时改用赋值方式传参，注意如果参数包含空格，需要用引号包裹：

make deploy DEPLOY_ARGS="server project"
# 或者换个顺序（适用于复杂场景）
make DEPLOY_ARGS="staging api-v2" deploy

需要注意的细节

• DEPLOY_ARGS= 这一行必须声明，即使为空。否则未定义的变量在 Make 中会展开为空字符串，可能导致脚本误判参数个数。
• 变量名中不要使用短横线（-），例如 DEPLOY-ARGS 不行——Make 只接受字母、数字和下划线。
• 如果参数中包含特殊字符（如 $、"、'），建议在 shell 层进行转义，或者使用 .ONESHELL: 和 $(shell ...) 增强灵活性。
• 如果需要默认参数，可以使用 DEPLOY_ARGS = default-env，= 表示“仅在变量未设置时赋值”。

如果追求更接近 CLI 的体验，也可以通过 shell 函数做一层封装，但这已经超出 Make 的原生能力范围。核心原则始终不变：Make 的命令行是它的调度接口，不是用户参数通道。坚持使用变量传递参数，既符合 Make 的设计哲学，也能保证构建的可复现性与跨平台兼容性。