关键在于用pyenv+homebrew构建受控版本管理体系：先装homebrew和pyenv，配置~/.zshrc三行环境变量并source生效，再装编译依赖及指定python版本，最后通过pyenv global/local/shell三级命令按需切换，确保python --version和which python指向正确路径。
在 macos 中实现多 python 版本平稳切换，关键不是手动改 path 或硬写 alias，而是用 pyenv + homebrew 构建一套受控、可预测、作用域清晰的版本管理体系。系统自带 python 不动，所有第三方版本由 pyenv 统一安装和调度，环境变量只负责“启动 pyenv”，不直接绑定具体路径。
装好 Homebrew 和 pyenv
先确保基础工具就位：
- 运行
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装 Homebrew（已装则跳过） - 执行
brew update && brew install pyenv
正确初始化 pyenv 到 shell 环境
macOS 默认用 zsh，编辑 ~/.zshrc，追加三行（顺序不能错）：
export PYENV_ROOT="$HOME/.pyenv"export PATH="$PYENV_ROOT/bin:$PATH"-
eval "$(pyenv init -zsh)"（注意是-zsh，新版更稳定，不是pyenv init -）
保存后运行 source ~/.zshrc，再敲 pyenv --version 有输出即成功。
装依赖再装 Python 版本
pyenv 编译安装需要底层库支持：
- 运行
brew install openssl readline sqlite3 xz zlib - M 系列芯片额外执行：
echo 'export LDFLAGS="-L/opt/homebrew/opt/zlib/lib -L/opt/homebrew/opt/openssl/lib"' >> ~/.zshrcecho 'export CPPFLAGS="-I/opt/homebrew/opt/zlib/include -I/opt/homebrew/opt/openssl/include"' >> ~/.zshrc
再source ~/.zshrc - 查可用版本：
pyenv install --list | grep "^[0-9]\+\.[0-9]\+\.[0-9]\+$" - 装两个常用版，例如：
pyenv install 3.11.9 3.12.5
按需切换，不冲突
pyenv 提供三级作用域，互不影响：
-
全局默认：运行
pyenv global 3.11.9，新打开终端都用这个 -
项目专属：进项目目录后运行
pyenv local 3.12.5，会生成.python-version文件，cd 进来自动生效 -
当前会话临时：运行
pyenv shell 3.12.5，只影响当前终端窗口，关掉就还原
每次切换后，用 python --version 和 which python 验证是否指向 ~/.pyenv/versions/xxx/bin/python 路径。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
