引入.env.local后Makefile命令输出格式异常求助

问题根源 #

直接用include .env.local会把.env.local当作Makefile的一部分解析，哪怕文件是空的，也会让$(MAKEFILE_LIST)包含这个文件。如果你的命令列表（help信息）是通过解析Makefile注释生成的，多文件解析会导致工具（比如grep/awk）输出文件名前缀，破坏原本的格式。

解决方案 #

方案1：改用Shell加载环境变量（推荐） #

移除include .env.local和export，替换成以下代码，既加载.env.local的变量，又不会把它当作Makefile的一部分：

# 加载.env.local中的环境变量（跳过注释行）
ifneq (,$(wildcard .env.local))
    $(foreach line,$(shell grep -v '^#' .env.local),$(eval export $(line)))
endif

方案2：调整Help命令的解析逻辑 #

如果坚持用include，修改生成命令列表的逻辑，只处理主Makefile文件，排除include的外部文件：
假设你的help目标原本是这样的，修改为：

help: ## 显示命令列表
	@awk 'BEGIN {FS = ":.*##"; printf "\nDocker\n-------------\n"} 
		/^##/ {printf "%s\n", substr($$0, 3)} 
		/^[a-zA-Z_-]+:.*?##/ {printf "  %-20s %s\n", $$1, $$2}' Makefile

这里直接指定Makefile而非$(MAKEFILE_LIST)，避免解析.env.local文件。

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