使用pyenv可实现Mac系统Python多版本精细化管理：先通过Homebrew安装并配置pyenv，再安装指定版本，支持全局、局部（.python-version文件）和临时（当前shell）三种切换模式。
如果您在Mac系统中安装了多个Python版本，但无法灵活切换以适配不同项目需求，则可能是由于缺乏统一的版本管理工具。以下是使用pyenv实现Python版本精细化管理与切换的操作步骤：
一、安装pyenv
pyenv是一个专为管理多个Python版本设计的命令行工具，它通过修改PATH环境变量，使指定版本的Python优先被调用。安装前需确保系统已配置Homebrew包管理器。
1、打开终端，执行命令安装pyenv：
brew install pyenv
2、验证安装是否成功：
pyenv --version
3、若提示命令未找到，请将pyenv初始化脚本添加至shell配置文件（如~/.zshrc）：
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
4、继续追加初始化语句：
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
5、最后重新加载配置：
source ~/.zshrc
二、查看并安装所需Python版本
pyenv内置版本列表可查询所有支持安装的Python版本，包括CPython官方发行版及PyPy等变体。安装过程独立于系统Python，互不干扰。
1、列出所有可安装的Python版本：
pyenv install --list
2、筛选出常用稳定版本（如3.9.18、3.11.9、3.12.3）：
pyenv install 3.9.18
3、等待编译完成，安装完成后确认已注册版本：
pyenv versions
4、若安装失败，检查是否已安装Xcode命令行工具：
xcode-select --install
三、全局设置默认Python版本
全局设置影响整个用户环境下的默认Python解释器，适用于多数日常开发场景，但不推荐用于多项目混用环境。
1、查看当前全局版本：
pyenv global
2、将Python 3.11.9设为全局默认版本：
pyenv global 3.11.9
3、验证生效情况：
python --version
4、注意：执行后所有新打开的终端窗口均会继承该设置
四、为特定目录设置局部Python版本
局部版本设置通过在目标项目根目录下生成.python-version文件实现，优先级高于全局设置，是多项目协同开发的核心机制。
1、进入项目目录：
cd /path/to/your/project
2、设置当前目录使用的Python版本：
pyenv local 3.9.18
3、该操作会在目录下自动生成.python-version文件，内容为“3.9.18”
4、退出该目录后，自动恢复上一级或全局设定版本
5、若需清除局部设置，执行pyenv local --unset即可删除.python-version文件
五、临时切换Python版本（仅当前Shell会话）
临时版本切换不会修改任何配置文件，仅作用于当前终端窗口，适合快速验证或调试用途。
1、启动临时环境并指定版本：
pyenv shell 3.12.3
2、验证当前Shell中的Python版本：
python --version
3、关闭当前终端或执行以下命令退出临时环境：
pyenv shell --unset
4、该方式不影响其他终端窗口及系统级配置
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
