Makefile无法正确执行命令，Shell正常Makefile异常的解决咨询

这种情况我简直太熟悉了！很多人第一次把Shell命令移到Makefile里都会踩这些坑——毕竟Make的执行逻辑和咱们直接在终端敲命令的环境差得挺多的。下面是几个最常见的问题和对应的解决办法，你可以挨个排查：

1. Make默认用的Shell不是你日常用的Shell #

默认情况下，Make会调用/bin/sh来执行命令，而不是你终端里的bash（或者zsh）。很多bash特有的语法（比如数组、[[ ]]条件判断、==字符串比较）在sh里根本不支持，这就会导致命令跑不起来。

• 解决办法：在Makefile的最开头指定使用bash：

  SHELL := /bin/bash
  

2. Make的变量规则会吃掉你的$符号 #

在Make里，$是用来引用Make变量的标记。如果你的Shell命令里有$（比如正则里的$1、Shell变量$USER），Make会先把它当成自己的变量去展开，结果传到Shell里的命令就变味了。

• 解决办法：把命令里的每个$都改成$$，让Make把它转义后再传给Shell：
  比如终端里的命令是：

  echo "当前用户是 $USER"
  

  放到Makefile里得写成：

  show-user:
      echo "当前用户是 $$USER"
  

3. Make逐行执行命令时，每行都是新的Shell进程 #

你在终端敲多行命令时，所有命令都在同一个Shell进程里跑，环境变量、当前目录这些状态都会保留。但Make默认给每行命令新开一个Shell，所以你如果写了cd /tmp，下一行的命令还是在原来的目录执行，根本没切换过去。

• 解决办法：
  • 把多行命令用&&连起来，放在同一行：

    temp-op:
        cd /tmp && touch test.txt && ls
    

  • 或者用反斜杠\把多行连起来，让Make把它们当成一个完整的Shell命令执行：

    temp-op:
        cd /tmp && \
        touch test.txt && \
        ls
    

  （用&&代替分号更安全，前面的命令失败了后面就不会继续执行）

4. 缩进必须用Tab键，空格会失效 #

Makefile对命令行的缩进有严格要求：必须用Tab键开头，如果你用了空格，要么报错，要么命令根本不执行。很多编辑器默认用空格代替Tab，这时候就会踩坑。

• 解决办法：在编辑器里开启显示空白字符的功能，检查命令行开头是不是Tab；如果你的编辑器自动转空格为Tab，确认这个功能是开启的。

5. Make的环境变量不全，和终端不一样 #

你终端里的环境变量（比如自定义的PATH、自己设的变量）在Make执行时不一定会被继承，因为Make默认是在一个相对干净的环境里运行的。

• 解决办法：
  • 执行Make时手动传递环境变量：export MY_VAR=hello; make
  • 或者在Makefile里直接设置并导出环境变量：

    export PATH := /usr/local/bin:$(PATH)
    show-path:
        echo $$PATH
    

6. 通配符、管道、重定向被Make提前解析 #

比如你用*.txt，Make会先自己展开通配符，而不是交给Shell处理；管道|或者重定向>也可能被Make干扰，导致命令逻辑变形。

• 解决办法：直接用bash来包裹整个命令，让Make完全不解析里面的符号：

  process-files:
      @bash -c 'ls *.txt | grep test > output.txt'
  

  （加@是让Make不打印执行的命令，如果你想看到命令执行过程，可以去掉@）

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