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

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

正确写法

FROM python:3.12-slim

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

COPY bin/hello /opt/app/bin/hello
RUN chmod +x /opt/app/bin/hello
CMD ["hello"]   # bin/hello需是带有效shebang的脚本或可执行文件

反面教材：RUN 里 export

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

每条 RUN 都是独立 shell，层与层之间环境变量不传递——持久声明通常用ENV；entrypoint脚本也可在运行时export后exec启动应用。

Python命令工具推荐先创建venv并将/opt/venv/bin加入PATH；仅pip --prefix安装并加bin不保证Python能找到对应site-packages。本文PATH分隔符按Linux容器，不直接套用于Windows。运行时-e PATH需防宿主$PATH被提前展开。

其他写法补充

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 可以作为镜像的运行环境约定；密码和访问令牌应使用部署时的秘密管理机制提供，并避免出现在镜像层、构建日志和后续采集日志里。

常见问题（FAQ）

Q：容器启动后还能改 PATH 吗？
A：进程可修改自身环境并传给之后创建的子进程，但其他进程不会自动同步；docker exec -e 只对 exec 的这条命令生效，改不了主进程的。

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

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