关键不是装多个Python，而是pyenv管解释器版本+venv隔离项目依赖：用pyenv安装切换Python版本，每个项目用python -m venv .venv创建独立环境，激活后pip install仅影响本项目，配合requirements.txt和direnv提升体验。
在 macos 上实现多项目并行开发的 python 环境隔离，关键不是“装多个 python”，而是建立解释器版本与项目依赖两层独立控制。系统自带 python 不可动，homebrew 安装的 python 也不建议直接用 pip 装包——稳妥路径是 pyenv 管理解释器 + venv 隔离项目，轻量、标准、无额外依赖冲突。
用 pyenv 管理不同 Python 解释器版本
每个项目可能需要特定 Python 版本（比如旧项目需 3.8，新项目需 3.12），pyenv 能让你在不修改系统 PATH 的前提下按需切换：
- 先装好 Homebrew 和编译依赖：
brew install openssl readline sqlite3 xz zlib tcl-tk；Apple Silicon 用户额外配置LDFLAGS和CPPFLAGS - 执行
brew install pyenv，再把三行初始化代码写入~/.zshrc并source ~/.zshrc - 查看可用版本：
pyenv install --list | grep "3\.[89]"；安装指定版本如pyenv install 3.8.18 - 设为全局默认：
pyenv global 3.11.9；仅对当前项目目录生效：pyenv local 3.8.18（会自动生成.python-version） - 验证：
python --version和which python应指向~/.pyenv/shims/python
为每个项目创建独立 venv 环境
即使 Python 版本相同，不同项目也必须用各自 venv，否则 pip install 会污染共享 site-packages：
- 进入项目根目录，运行
python -m venv .venv（注意空格和点号，生成隐藏文件夹） - 激活：
source .venv/bin/activate，终端提示符前出现(.venv) - 此时
which python和which pip都指向.venv内路径，pip list只显示该环境包 - 退出用
deactivate；删除整个环境只需rm -rf .venv - 常见错误：忘记激活就 pip install → 包被装进系统 Python；误删 .venv 后没重装依赖 → 运行报 ImportError
依赖管理推荐原生组合：requirements.txt + pip
不用 pipenv 或 poetry 是因它们在 macOS zsh 下存在子 shell 兼容性问题（如 CommandNotFoundError），而原生方案更稳定、易调试：
- 激活环境后，先升级 pip：
pip install --upgrade pip - 安装所需包：
pip install requests flask - 导出精确依赖：
pip freeze > requirements.txt - 新机器或协作时，先建 venv、激活，再执行：
pip install -r requirements.txt - 如需锁定间接依赖（提升复现性），可用
pip-tools：写requirements.in，运行pip-compile生成带哈希的requirements.txt
提升体验的小技巧
手动 source 激活略繁琐，可用工具自动处理：
立即学习“Python免费学习笔记（深入）”；
-
direnv：安装后在项目根目录放
.envrc，内容为source .venv/bin/activate，cd 进目录自动激活，cd 出自动退出 - 避免踩坑：不要用
pip install --user，它把包装进~/Library/Python/x.y/lib/python/site-packages/，仍是用户级全局，无法按项目隔离 - VS Code 或 PyCharm 中，打开项目后在命令面板选择 Interpreter，定位到
.venv/bin/python即可自动识别环境，补全、调试全部正常
