MacOS下Makefile无法识别Python venv目录的问题排查

问题描述 #

为MacOS项目编写的Makefile包含如下init目标：

init:
    python3 -m venv venv
    source venv/bin/activate
    pip install --upgrade pip
    pip install -r requirements.txt

预期功能是创建虚拟环境、激活环境并安装依赖，但执行make init时出现错误：

python3 -m venv venv
source venv/bin/activate
make: source: No such file or directory
make: *** [init] Error 1

手动执行命令正常，但Makefile中无法正常运行。

原因分析 #

1. Shell差异：Make默认使用/bin/sh作为执行命令的shell，而source是Bash的内置命令，MacOS上的/bin/sh不支持该命令，因此报错“source: No such file or directory”。
2. 进程隔离：即使解决了source的问题，Makefile中每一行命令都会在单独的子shell中执行，激活虚拟环境的操作仅对当前子shell生效，后续的pip命令仍会使用系统全局的pip，无法实现依赖安装到虚拟环境的目的。

解决方案 #

方案一：统一在单个shell进程执行，替换source为. #

修改Makefile，将所有命令放在同一个shell进程中执行，同时用sh支持的.命令代替source：

init:
    python3 -m venv venv && \
    . venv/bin/activate && \
    pip install --upgrade pip && \
    pip install -r requirements.txt

使用&&确保前一个命令执行成功才会执行下一个，反斜杠\用于换行保持代码可读性，所有命令会在同一个shell进程中运行，激活虚拟环境的效果能覆盖后续的pip操作。

方案二：直接调用虚拟环境内的pip，无需激活环境 #

跳过激活虚拟环境的步骤，直接指定虚拟环境中pip的绝对路径：

init:
    python3 -m venv venv
    venv/bin/pip install --upgrade pip
    venv/bin/pip install -r requirements.txt

这种方式更简洁，避免了shell差异和进程隔离的问题，直接明确使用虚拟环境内的pip工具。

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