pyenv是python多版本共存场景下唯一合理的选择，它通过shims机制实现无侵入、三级优先级（shell/local/global）的解释器精准调度，不污染系统python和全局pip。
直接说结论：pyenv 不是“推荐用”，而是 Python 多版本共存场景下**唯一合理的选择**——它不碰系统 Python，不依赖 sudo，不污染全局 pip，且能按 shell、目录、项目三级精准控制 Python 解释器路径。
pyenv 的 PATH 劫持机制为什么比 alias 或 ln 更可靠
很多人试过用 alias python=python3.9 或 ln -sf /usr/local/bin/python3.9 /usr/local/bin/python，但很快会遇到问题：
- alias 只对交互式 shell 生效，
#!/usr/bin/env python脚本完全不认； - ln 方式会覆盖系统级命令，
apt upgrade或yum update可能直接崩掉依赖 Python 的系统工具（比如 Ubuntu 的apt本身）； - pyenv 的
shims是在$PYENV_ROOT/shims目录下生成一堆轻量脚本（如python、pip、idle），它们在运行时才动态查版本、转发调用，既透明又可追溯。
关键点：shims 本质是 bash 脚本，执行 which python 看到的是 ~/.pyenv/shims/python，不是硬链接或别名，所有子进程都继承这个行为。
shell / local / global 三档版本优先级怎么实际生效
pyenv 查找 Python 版本的顺序是硬编码逻辑：先看 PYENV_VERSION 环境变量（pyenv shell 设置），再找当前目录及向上逐层的 .python-version（pyenv local 生成），最后 fallback 到 ~/.pyenv/version（pyenv global）。这不是“建议”，而是每次执行 python 命令时真实走的流程。
-
pyenv shell 3.11.9→ 立即生效，但只影响当前终端，关掉就失效； -
pyenv local 3.8.18→ 在当前目录写入.python-version，cd 进来自动切，cd 出去自动回退； -
pyenv global 3.12.3→ 写进~/.pyenv/version，作为兜底版本，没被前两者覆盖时才用它。
注意：pyenv versions 输出里带 * 的才是当前生效版本；system 表示系统自带 Python（如 /usr/bin/python3），它永远排在最后，不会被自动选中。
安装新版本 Python 时最常卡在哪几个依赖上
pyenv 安装 Python 是从源码编译，不是包管理器一键装二进制。CentOS/RHEL 系要装齐 gcc 和各类 -devel 包，缺一个就报错退出，且错误信息往往藏在几百行日志末尾。
- 必装项（CentOS/AlmaLinux）：
gcc zlib-devel bzip2-devel openssl-devel sqlite-devel readline-devel tk-devel gdbm-devel xz-devel； - MacOS（M1/M2）额外注意：
openssl@3和readline要用 Homebrew 装，然后通过export PKG_CONFIG_PATH="/opt/homebrew/lib/pkgconfig"暴露路径； - 常见失败现象：
ModuleNotFoundError: No module named '_ssl'→ openssl-devel 没装或路径未被识别；ImportError: libffi.so.8: cannot open shared object file→ 编译时用了新版 libffi，但运行时找不到动态库，需加export LD_LIBRARY_PATH="/path/to/libffi/lib:$LD_LIBRARY_PATH"。
装完记得跑 pyenv rehash，否则新装的版本不会出现在 shims 里，python --version 仍显示旧版。
为什么不能跳过 pyenv-virtualenv 直接用 pip install -r requirements.txt
pyenv 管理的是解释器版本，不是包环境。即使你用 pyenv local 3.9.18 切到了正确 Python，pip install 默认仍装进该 Python 的 site-packages 全局路径，多个项目共用一套包，冲突概率极高。
- 正确做法是配合
pyenv-virtualenv插件：pyenv virtualenv 3.9.18 myproject-env创建隔离环境； - 再用
pyenv local myproject-env绑定目录，此时python和pip自动指向虚拟环境内的副本； - 注意：virtualenv 名字里不能有斜杠或空格，否则
pyenv local会解析失败； - 如果已用
python -m venv手动建过 env，pyenv 不识别它——必须用pyenv virtualenv创建，才能被pyenv local管理。
真正麻烦的从来不是“怎么切换版本”，而是“切换之后 pip 装到哪、import 从哪找、venv 怎么绑定目录”。这些细节不厘清，pyenv 就只是个花架子。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
