Ubuntu 20.04下pyenv配置后python命令版本与预期不符问题

• 首要原因是Bash内置的命令哈希缓存机制：在将pyenv的路径加入PATH之前，你已经执行过python命令，Bash会将python对应的实际路径/usr/bin/python（指向3.8.10版本）缓存到哈希表中。后续执行python时会优先调用缓存的路径，不会重新遍历PATH查找，因此出现which python返回pyenv路径但实际执行调用系统Python的异常。
• 次要原因是Dockerfile中的pyenv路径配置仅写入了~/.bashrc，该文件仅在交互式非登录shell场景下加载，若通过Docker RUN指令、非交互式执行命令等场景运行，不会加载该配置，也会导致路径不生效。
• pip命令正常的原因是你在配置pyenv前没有执行过pip命令，无历史缓存，首次执行pip时会从PATH中匹配到pyenv路径下的对应版本，因此指向正常。

临时修复（当前shell会话立即生效） #

执行命令清除python的哈希缓存即可：

hash -d python
# 若要清空所有命令缓存可执行 hash -r

执行后再运行python -V即可正确返回3.9.7版本。

永久修复（适配Docker环境，避免复现） #

调整Dockerfile配置：

1. 全局声明PATH环境变量，同时将pyenv配置写入所有shell都会加载的配置文件，覆盖所有运行场景：

# 替换原有pyenv配置段
RUN git clone https://github.com/pyenv/pyenv.git ~/.pyenv && \
    echo 'export PATH="$HOME/.pyenv/bin:$HOME/.pyenv/shims:$PATH"' >> ~/.bashrc && \
    echo 'export PATH="$HOME/.pyenv/bin:$HOME/.pyenv/shims:$PATH"' >> ~/.profile
# 全局配置PATH，确保所有shell场景都能优先加载pyenv路径
ENV PATH="/root/.pyenv/bin:/root/.pyenv/shims:${PATH}"

2. 若在Dockerfile中执行pyenv安装版本、设置全局的操作，完成后添加清缓存指令，避免构建过程中产生缓存：

RUN pyenv install 3.9.7 && \
    pyenv global 3.9.7 && \
    hash -r

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