macOS 多 Python 版本共存需明确指定解释器完整路径创建虚拟环境，用 pyenv local 绑定项目版本，统一 PATH 入口，VS Code 手动选择 .venv/bin/python 并重启窗口验证。
macos 上 python 虚拟环境本身不解决多版本共存问题，它只隔离依赖；真正要让 不同 python 版本创建的虚拟环境互不干扰、调用准确，关键在于：先明确指定解释器来源，再让 vs code 或终端稳定识别它——而不是依赖模糊的 python3 命令或系统 path 排序。
必须用完整路径创建和绑定虚拟环境
别用 python3 -m venv .venv 这种写法，它会调用当前 shell 的 python3，而这个命令可能指向系统、Homebrew 或 pyenv 管理的任意版本，不可控。
- 先确认你要用的 Python 解释器在哪：运行
which python3.12（假设你装了 3.12）或pyenv which 3.12.4，拿到类似/Users/xxx/.pyenv/versions/3.12.4/bin/python的完整路径 - 用该路径直接创建环境：
/Users/xxx/.pyenv/versions/3.12.4/bin/python -m venv .venv - VS Code 中通过 Python: Select Interpreter 手动选中
.venv/bin/python（带完整路径的条目），不要点“Python 3.12”这种文字描述 - 状态栏没更新？关掉整个 VS Code 窗口重开，仅关闭标签页无效
PATH 不要堆多个 Python 目录，只留一个“入口”
把所有 Python 安装路径（如 /opt/homebrew/bin、~/.pyenv/shims、/usr/local/bin）都塞进 $PATH，只会让 which python3 结果飘忽不定，终端和编辑器行为不一致。
- 在
~/.zprofile（不是.zshrc）里统一管理：只保留pyenv的 shims 或 Homebrew 的 bin，二选一作为主入口 - 例如用 pyenv 就写：
export PATH="$HOME/.pyenv/shims:$PATH"；用 Homebrew 就写：export PATH="/opt/homebrew/bin:$PATH" - 删掉其他地方重复的
export PATH=行，避免多头写入 - 新开终端验证：
which python3应该稳定输出一个路径，且与你打算用的版本一致
项目级绑定比全局切换更可靠
不用改 pyenv global 或反复 pyenv shell，每个项目自己决定用哪个版本，也方便协作。
- 进入项目根目录，运行：
pyenv local 3.12.4（自动写入.python-version文件） - 之后只要在这个目录下打开终端或 VS Code，
python命令就会自动指向 3.12.4，python -m venv .venv也就自然安全了 - VS Code 会读取该文件并推荐对应解释器，但依然建议手动确认一次路径是否正确
- Git 提交
.python-version，不提交.venv
避免踩坑的硬性习惯
- 永远不用
sudo pip install，也不在系统/usr/bin/python3下装任何开发包 - 不手动改
/usr/bin或/System下任何文件，SIP 会拦截，且破坏系统稳定性 - 不设
alias python=python3.12这类全局别名，它会让脚本行为不可预测 - 检查虚拟环境是否真生效：激活后运行
python -c "import sys; print(sys.executable)"，输出必须是.venv/bin/python路径
