如何在Docker构建时向bash脚本传递Poetry命令行选项？

问题根源 #

你遇到的问题并非“选项本身无效”，而是参数传递的方式存在漏洞，再加上Docker ARG作用域、bash变量展开的细节没处理到位，导致选项未被正确传递到脚本中。

修复方案 #

1. 调整Dockerfile的ARG定义与参数传递 #

• 将ARG的默认值设为空，这样默认执行普通的poetry install，需要时再手动传递选项
• 确保ARG定义在FROM指令之后（否则后续RUN阶段无法访问该变量）
• 传递参数时保留变量原样展开，保证含空格的多选项能被正确解析

修改后的Dockerfile示例：

# 基础镜像
FROM python:3.10-slim

# 定义可选参数，默认空值
ARG POETRY_OPTION=""

# 复制脚本并赋予执行权限
COPY my_script.sh /app/
RUN chmod +x /app/my_script.sh

# 执行脚本并传递参数
RUN cd /app && ./my_script.sh $POETRY_OPTION

2. 修改脚本以接收所有参数 #

把脚本里的poetry install $1改成poetry install "$@"，这样不管传递单个还是多个选项（比如-vvv --no-dev），都能完整传递给poetry命令。

修改后的my_script.sh示例：

#!/bin/bash
poetry install "$@"

使用方式 #

• 默认构建（无详细日志）：

  docker build -t my-app .
  

• 启用详细日志构建：

  docker build --build-arg POETRY_OPTION="-vvv" -t my-app .
  

• 传递多个选项（比如跳过开发依赖）：

  docker build --build-arg POETRY_OPTION="-vvv --no-dev" -t my-app .
  

原方法失效的原因 #

1. 脚本参数接收限制：用$1只能接收第一个参数，后续扩展多选项时会丢失部分内容；"$@"会原样传递所有参数，适配更复杂的场景。
2. ARG作用域问题：如果你的ARG定义在FROM之前，属于全局ARG，在FROM之后的构建阶段需要重新声明才能访问，否则变量为空。
3. 变量展开隐患：单选项-vvv用$1能生效，但如果参数含空格，不加双引号会被bash拆分成多个独立参数，导致命令执行异常。

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