Dockerfile 中如何修改 PATH 环境变量？

写法：用 ENV 指令——ENV PATH="/usr/local/bin:${PATH}"。${PATH} 引用旧值，新目录放前面则优先命中，放后面则作为补充。ENV 设置的变量对后续构建步骤和运行期容器都生效**；而 RUN 里 export PATH=... 只在那一层 shell 里有效，层结束即失效——最常见的错误就是后者。**

正确写法

FROM python:3.12-slim

# 把自定义目录加进 PATH（放最前，优先级最高）
ENV PATH="/opt/app/bin:${PATH}"

RUN pip install --prefix=/opt/app some-tool
CMD ["some-tool"]   # 能找到 /opt/app/bin/some-tool

反面教材：RUN 里 export

RUN export PATH="/opt/bin:$PATH"   # ❌ 只在这一层 shell 生效
RUN some-command                    # 新的一层，export 已失效，报错

每条 RUN 都是独立 shell，层与层之间环境变量不传递——要跨层生效只能用 ENV。

其他写法补充

ARG/ENV 组合（构建参数拼路径）：

ARG INSTALL_DIR=/opt/tool
ENV PATH="${INSTALL_DIR}/bin:${PATH}"

临时单步使用（不想永久改 PATH）：

RUN /opt/tool/bin/setup.sh    # 写绝对路径，不动 PATH

顺序的讲究

ENV PATH="/a:${PATH}" 与 ENV PATH="${PATH}:/a" 的差别在查找优先级：PATH 从左到右找，同名可执行文件排前面的目录胜出。想覆盖系统自带命令就放前面，想做补充就放后面。

观测云对照

环境变量进镜像要克制。 PATH 这类构建期变量用 ENV 没问题，但密码/Token 千万别 ENV 进镜像——docker history 可见。运行期配置用 -e/env_file 注入，观测侧也只该看到非敏感配置。

常见问题（FAQ）

Q：容器启动后还能改 PATH 吗？
A：进程环境在启动时定型；docker exec -e 只对 exec 的这条命令生效，改不了主进程的。

Q：ENV 和 docker run -e 谁优先？
A：-e 覆盖镜像里 ENV 的值，运行期注入优先。

Q：ENTRYPOINT 脚本里改 PATH 有用吗？
A：对脚本自己及其启动的进程有用（子进程继承），这也是初始化脚本里补 PATH 的常用做法。