在真实开发环境中，多个 Python 版本共存几乎是常态。老项目依赖旧版本，新框架要求新版本，CI 需要多版本测试，频繁修改 PATH 或重装解释器不仅低效还容易造成环境混乱。 本文系统讲解 pyenv 的设计理念与核心原理（shim 机制与 PATH 劫持），涵盖 Linux、macOS 与 Windows（pyenv-win）安装方式、常用命令清单、版本切换逻辑、升级卸载方式以及常见坑位分析。同时对比 pyenv 与 Conda 的使用场景，帮助开发者建立清晰的多版本管理方案。 适合希望构建干净、可控、多版本 …