Makefile动态Help目标无法解析.env变量问题求助

首先确保你的Makefile正确加载并导出.env中的变量，这是实现动态解析的基础：

# 加载项目根目录的.env文件，并导出所有变量到环境中
ifneq (,$(wildcard ./.env))
    include .env
    export
endif

以下提供两种可行方案，让Help目标能解析注释中的.env变量，同时保留美观的输出格式：

方案1：通过awk直接读取环境变量替换 #

无需生成临时文件，直接在awk处理时替换注释里的${VAR}语法：

help: ## 显示包含.env变量的动态帮助信息
	@awk 'BEGIN {FS = ":.*##"; printf "\n\033[1mUsage:\033[0m\n  make \033[36m<target>\033[0m\n\n"} \
	/^##@/ { printf "\033[1m%s\033[0m\n", substr($$0, 5) } \
	/^[a-zA-Z_-]+:.*?##/ { \
		gsub(/\$\{([^}]+)\}/, ENVIRON[\1], $$2); \
		printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2 \
	}' $(MAKEFILE_LIST)

说明 #

• gsub(/\$\{([^}]+)\}/, ENVIRON[\1], $$2) 会把注释部分（$$2）里的${VAR}替换成环境变量VAR的实际值，因为我们已经通过export将.env变量导入到环境中，awk可通过ENVIRON数组直接访问。
• 保留了原有的ANSI彩色格式，保证Help目标的美观性。

方案2：先通过Make展开变量再处理 #

如果你的注释里包含复杂的Make变量语法，这种方法兼容性更强：

help: ## 显示动态帮助信息
	@$(MAKE) -f $(MAKEFILE_LIST) --no-print-directory expand-makefile | \
	awk 'BEGIN {FS = ":.*##"; printf "\n\033[1mUsage:\033[0m\n  make \033[36m<target>\033[0m\n\n"} \
	/^##@/ { printf "\033[1m%s\033[0m\n", substr($$0, 5) } \
	/^[a-zA-Z_-]+:.*?##/ { \
		printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2 \
	}'

# 辅助目标：展开Makefile中的所有变量
expand-makefile:
	@sed 's/\$\([a-zA-Z_][a-zA-Z0-9_]*\)/$(\1)/g' $(MAKEFILE_LIST)

说明 #

• expand-makefile目标通过sed将Makefile里的$VAR语法替换为实际值，再传递给awk处理。
• --no-print-directory参数避免Make输出额外的目录信息，保证Help输出干净整洁。

使用示例 #

假设你的.env文件内容如下：

DEPLOY_ENV=production
API_URL=https://api.example.com

在Makefile的目标注释中引用这些变量：

deploy: ## 部署应用到 ${DEPLOY_ENV} 环境，API地址为 ${API_URL}
	@echo "Deploying to ${DEPLOY_ENV}..."

运行make help后，会输出解析后的帮助文本：

Usage:
  make <target>

deploy           部署应用到 production 环境，API地址为 https://api.example.com

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