如何在Docker镜像中安装两个Python版本并在构建时切换

原配置存在的问题 #

• 重复执行COPY swap.sh和切换用户执行脚本，完全冗余
• 二进制文件复制逻辑混乱，链接创建语句逻辑错误（判断文件不存在才创建链接，且目标路径写错）
• 未设置DEFAULT_PYTHON_VERSION的默认值，构建时未传参会直接报错
• 仅切换python软链接，未同步对应版本的pip，导致工具与Python版本不匹配

优化后的Dockerfile #

# 定义构建参数，默认使用Python 3.9
ARG DEFAULT_PYTHON_VERSION=3.9

# 基础镜像选择轻量的debian镜像，按需调整
FROM debian:bookworm-slim AS base
RUN apt-get update && apt-get install -y --no-install-recommends \
    build-essential \
    wget \
    curl \
    && rm -rf /var/lib/apt/lists/*

# 拉取官方Python 3.9镜像作为构建阶段
FROM python:3.9-slim AS python39

# 拉取官方Python 3.10镜像作为构建阶段
FROM python:3.10-slim AS python310

# 最终镜像构建阶段
FROM base AS final
ARG DEFAULT_PYTHON_VERSION
ARG DEV_USER=developer

# 创建非root开发用户
RUN useradd -m ${DEV_USER}

# 分别复制两个版本的完整Python环境到独立目录，避免文件冲突
COPY --from=python39 --chown=${DEV_USER}:${DEV_USER} /usr/local/ /usr/local/python39/
COPY --from=python310 --chown=${DEV_USER}:${DEV_USER} /usr/local/ /usr/local/python310/

# 为两个版本创建基础可执行文件软链接
RUN ln -s /usr/local/python39/bin/python3.9 /usr/local/bin/python3.9 && \
    ln -s /usr/local/python39/bin/pip3.9 /usr/local/bin/pip3.9 && \
    ln -s /usr/local/python310/bin/python3.10 /usr/local/bin/python3.10 && \
    ln -s /usr/local/python310/bin/pip3.10 /usr/local/bin/pip3.10

# 复制版本切换脚本并赋予执行权限
COPY sagacity-cd/swap.sh /usr/local/bin/
RUN chmod +x /usr/local/bin/swap.sh

# 根据构建参数设置默认Python版本
RUN /usr/local/bin/swap.sh ${DEFAULT_PYTHON_VERSION}

# 切换到非root用户
USER ${DEV_USER}
WORKDIR /home/${DEV_USER}

优化后的swap.sh #

#!/bin/bash

# 定义支持的Python版本列表
SUPPORTED_VERSIONS=("3.9" "3.10")

# 校验输入版本是否合法
if [[ ! " ${SUPPORTED_VERSIONS[@]} " =~ " $1 " ]]; then
    echo "错误：无效的版本号，支持版本为：${SUPPORTED_VERSIONS[*]}"
    exit 1
fi

# 同步切换所有相关软链接，保证版本一致
echo "正在切换默认Python版本到${1}..."
rm -f /usr/local/bin/python /usr/local/bin/python3 /usr/local/bin/pip /usr/local/bin/pip3
ln -s /usr/local/bin/python${1} /usr/local/bin/python
ln -s /usr/local/bin/python${1} /usr/local/bin/python3
ln -s /usr/local/bin/pip${1} /usr/local/bin/pip
ln -s /usr/local/bin/pip${1} /usr/local/bin/pip3

echo "切换完成！当前默认版本：$(python --version)"

关键优化点说明 #

• 分层构建：利用官方Python镜像作为构建阶段，避免手动编译安装，既减少镜像体积又保证环境可靠性
• 环境隔离：两个Python版本分别存放在独立目录，彻底避免文件冲突
• 完整版本同步：同时切换python/python3/pip/pip3的软链接，确保工具与Python版本匹配
• 默认参数兜底：给构建参数设置默认值，未传参时自动使用3.9版本
• 冗余消除：移除重复的COPY和执行步骤，精简构建流程
• 健壮性提升：脚本增加版本合法性校验，避免无效输入导致构建失败

构建命令示例 #

# 使用默认3.9版本构建镜像
docker build -t multi-python:3.9 .

# 指定3.10版本构建镜像
docker build -t multi-python:3.10 --build-arg DEFAULT_PYTHON_VERSION=3.10 .

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