Python多版本管理核心是隔离环境、按需切换，关键在快速可靠绑定项目对应版本与包；pyenv管解释器版本，venv管包依赖，二者组合使用可高效避免冲突。
Python 多版本管理的核心是隔离环境、按需切换，避免系统 Python 被污染或项目间依赖冲突。关键不在于装多少个 Python，而在于能否快速、可靠地为不同项目绑定对应版本和包。
用 pyenv 管理 Python 解释器版本
pyenv 是最主流的 Python 版本管理工具，专用于下载、编译、切换不同 Python 解释器（如 3.8.10、3.11.9、3.12.3），不涉及虚拟环境本身。
- 安装后执行 pyenv install --list 查看可安装版本；常用命令如 pyenv install 3.11.9 编译安装
- 全局设置：pyenv global 3.11.9；当前目录局部设置：pyenv local 3.9.18（会在目录下生成 .python-version 文件）
- 切换后运行 python --version 可验证生效，它通过 shell shim 动态调整 PATH 实现
用 venv 或 virtualenv 创建隔离环境
解释器版本确定后，每个项目应配独立虚拟环境，防止包版本互相干扰。Python 3.3+ 自带 venv 模块，轻量够用。
- 进入项目目录，运行 python -m venv .venv（假设当前 Python 是 pyenv 切换好的 3.10.12）
- 激活：source .venv/bin/activate（macOS/Linux）或 .venv\Scripts\activate（Windows）
- 激活后 pip list 只显示该环境下的包，pip install 不影响其他项目或系统
组合使用：pyenv + venv 是推荐工作流
二者分工明确：pyenv 管“用哪个 Python”，venv 管“在这个 Python 下装哪些包”。无需额外工具也能高效协作。
立即学习“Python免费学习笔记（深入）”；
- 例如：项目 A 需 Python 3.9 + Django 4.2，项目 B 需 Python 3.12 + Django 5.1 → 分别用 pyenv local 设定版本，再各自建 .venv
- 可配合 pyenv-virtualenv 插件简化操作（如 pyenv virtualenv 3.11.9 myproject-env），但非必需
- 注意：不要用 pip install --user 安装包来替代虚拟环境，它仍共享 site-packages，隐患大
避免踩坑的几个细节
多版本管理容易因路径、缓存或权限出问题，提前留意能省去大量调试时间。
- 确保 shell 配置文件（~/.zshrc 或 ~/.bashrc）已正确加载 pyenv 初始化代码，否则 pyenv 命令不可用
- macOS 上若编译失败，常因 Xcode 命令行工具缺失：运行 xcode-select --install
- Linux 编译报错缺少依赖时，先安装基础开发包，如 Ubuntu 执行 sudo apt-get install -y make build-essential libssl-dev libffi-dev python3-dev
- VS Code 中需在命令面板（Ctrl+Shift+P）选择正确的 Python 解释器路径，通常为 ~/.pyenv/versions/xxx/bin/python
