macos 上应使用 pyenv 管理 python 版本 + python -m venv 创建虚拟环境：先用 pyenv install 安装多版本，pyenv local 设定项目版本并生成 .python-version，再执行 python -m venv .venv 创建隔离环境，source .venv/bin/activate 激活，避免 virtualenv、系统路径修改及全局 pip 安装。

macos 上管理多个 python 版本共存的虚拟环境，关键不是“为每个版本单独建一堆 venv”，而是用 pyenv 控制解释器版本 + python -m venv 创建隔离环境 的组合方式。这样既能自由切换底层 python 版本，又能保证每个项目依赖干净独立。

先让 pyenv 管好 Python 解释器版本

所有虚拟环境都基于某个具体的 Python 二进制文件。所以第一步是装好几个版本，并能按需激活：

• 安装常用版本：比如 pyenv install 3.9.18 3.11.9 3.13.3
• 进项目目录后设局部版本：cd myproject && pyenv local 3.11.9 → 自动生成 .python-version 文件
• 验证是否生效：python --version 应输出 3.11.9，which python 应指向 ~/.pyenv/shims/python

再用原生 venv 搭配当前版本建环境

pyenv 激活哪个版本，python -m venv 就用哪个版本创建环境，无需额外指定路径：

Claw Code Suite (Python-Only Edition)

仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...

下载

• 在项目根目录运行：python -m venv .venv
• 激活：source .venv/bin/activate
• 此时 which python 变成 ./.venv/bin/python，pip list 只显示本项目包
• 不同项目可各自用不同 Python 版本 + 各自的 .venv，互不干扰

避免常见混淆点

很多问题其实源于误操作或路径错乱：

• 不要用 pip install virtualenv 再调 virtualenv -p python3.9 —— 原生 venv 更轻量、更可靠
• 别手动改 /usr/local/bin/python3 或 /opt/homebrew/bin/python3 的软链接，它们和 pyenv 无关
• 不推荐全局 pip install -g，容易跨项目污染；需要命令行工具（如 black）时，建议装在对应项目的 .venv 里
• 检查 ~/.zshrc 中 pyenv 初始化代码是否在最后生效，顺序错误会导致 which python 仍指向系统路径

进阶：自动激活虚拟环境（可选）

如果希望每次进入项目目录就自动激活 .venv，可以加 direnv：

• 安装：brew install direnv
• 在 ~/.zshrc 加：eval "$(direnv hook zsh)"，再 source ~/.zshrc
• 进项目目录，新建 .envrc 文件，内容为：source .venv/bin/activate
• 首次运行 direnv allow 授权，之后进出目录自动处理

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！