Makefile向Docker容器传递bash命令时的变量转义问题

问题重现 #

编写的Makefile： #

execute:
	@echo $(COMMAND)
	docker exec -it my-dev-container $(COMMAND)

执行命令及错误结果： #

$ make execute COMMAND="bash -c 'echo $VARIABLE_ONLY_EXIST_IN_CONTAINER'"
bash -c echo
<< EMPTY >>

期望结果： #

$ make execute COMMAND="bash -c 'echo $VARIABLE_ONLY_EXIST_IN_CONTAINER'"
I_AM_A_VARIABLE_VALUE_WITHIN_THE_CONTAINER

直接执行Docker命令可正常获取结果： #

docker exec -it my-dev-container bash -c 'echo $VARIABLE_ONLY_EXIST_IN_CONTAINER'  
I_AM_A_VARIABLE_VALUE_WITHIN_THE_CONTAINER

原因分析 #

问题源于两层解析逻辑冲突：

1. 终端输入命令时，双引号内的$VARIABLE_ONLY_EXIST_IN_CONTAINER会被当前shell优先解析——由于该变量仅存在于容器内，当前shell无此定义，直接被替换为空，最终传递给Make的COMMAND实际是bash -c 'echo '。
2. Make本身还会对变量中的$做二次解析，即便shell未替换，Make也会尝试展开变量，结果同样为空。

解决方法 #

方法1：调用Make时转义$符号 #

给$加反斜杠，阻止当前shell解析变量，让\$传递给Make后被解析为$，最终交给容器内的bash处理：

$ make execute COMMAND="bash -c 'echo \$VARIABLE_ONLY_EXIST_IN_CONTAINER'"

方法2：用单引号包裹COMMAND参数 #

单引号会完全阻止当前shell解析内部内容，直接传递完整字符串给Make；同时内部改用双引号，保证容器内的bash能正常解析环境变量：

$ make execute COMMAND='bash -c "echo $VARIABLE_ONLY_EXIST_IN_CONTAINER"'

方法3：修改Makefile避免二次解析 #

如果需要固定命令逻辑，可在Makefile中用$$转义$，确保变量解析权完全交给容器bash：

execute:
	@echo $(COMMAND)
	docker exec -it my-dev-container bash -c 'echo $$VARIABLE_ONLY_EXIST_IN_CONTAINER'

若要保持COMMAND的灵活性，优先使用前两种调用时的转义方式。

总结 #

核心原则是让$VARIABLE_ONLY_EXIST_IN_CONTAINER的解析权完全归容器内的bash，避免被当前shell或Make提前展开，通过调整引号或转义$即可解决问题。

内容的提问来源于stack exchange，提问作者Ewro