M1 Mac下Docker构建提示Cargo未安装的问题求助

问题根源 #

你遇到的错误是因为requirements.txt里有某个Python包需要Rust工具链编译（比如cryptography、基于pyo3开发的包这类）。容器环境和你的Mac主机完全隔离，主机上的Cargo路径对容器无效，且你尝试在requirements.txt里加cargo/rust也没用——因为这些不是Python包，pip无法安装它们。

根本解决方法 #

1. 在Docker容器内安装Rust工具链 #

修改Dockerfile，在RUN pip install步骤前添加Rust的安装命令（适配Debian系的python-slim镜像）：

FROM python:3.8.1-slim

ENV PYTHONUNBUFFERED 1 
EXPOSE 8000
WORKDIR /app

# 安装编译依赖与Rust工具链
RUN apt-get update && apt-get install -y --no-install-recommends curl gcc && \
    # 非交互式安装Rust，采用默认配置
    curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y && \
    # 将Cargo加入环境变量，确保后续pip能调用
    echo 'source $HOME/.cargo/env' >> $HOME/.bashrc && \
    . $HOME/.cargo/env

COPY ./requirements.txt .
COPY ./src .
RUN pip install --verbose -r requirements.txt

CMD ["uvicorn", "--host", "0.0.0.0", "--port", "8000", "src.main:app"]

这样容器内就具备了完整的Rust工具链，pip编译依赖包时就能找到Cargo了。

2. 使用预编译wheel包跳过编译 #

如果不想安装Rust，可以让pip优先使用预编译的wheel包（适配M1的arm64架构）：
修改Dockerfile中的pip安装命令，添加--only-binary :all:参数：

RUN pip install --verbose --only-binary :all: -r requirements.txt

注意：不是所有包都提供arm64架构的预编译wheel，如果某个包没有，还是会触发编译报错，这时就得用第一种方法。

3. 定位具体依赖包 #

如果你想明确是哪个包需要Rust，可以在Mac主机上执行：

pip install -r requirements.txt -v

查看输出日志，找到触发"Checking for Rust toolchain"的包，之后可针对性处理（比如替换为无需编译的替代包，或单独为该包配置编译环境）。

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