macOS上Python虚拟环境管理的核心是分层隔离：系统Python保持只读受保护，用pyenv安装独立解释器版本，再用venv为每个项目创建独立依赖空间，并在VS Code中手动指定解释器路径以确保同步。
macos 上管理 python 虚拟环境，核心不是“绕开系统 python”，而是明确分层：系统 python 保持只读、不可动；所有开发工作在独立解释器 + 独立虚拟环境中进行。系统自带的 /usr/bin/python3 受 sip（系统完整性保护）和 pep 668 限制，禁止 pip 安装任何包——这不是缺陷，而是设计保护。
用 pyenv 管理解释器版本，不碰系统 Python
系统 Python 不可升级、不可卸载、也不该被 pip 修改。正确做法是用 pyenv 安装全新、干净的 Python 版本，并让 shell 自动切换：
- 先装编译依赖：
brew install openssl readline sqlite3 xz zlib tcl-tk；Apple Silicon 用户额外运行：export LDFLAGS="-L/opt/homebrew/lib"和export CPPFLAGS="-I/opt/homebrew/include" - 安装 pyenv：
brew install pyenv，再把三行初始化代码（export PYENV_ROOT=...、export PATH=...、eval "$(pyenv init -)"）追加到~/.zshrc并执行source ~/.zshrc - 查看并安装所需版本，例如：
pyenv install 3.9.18；设为项目专用：cd myproject && pyenv local 3.9.18（自动生成.python-version） - 验证：
python --version应显示 3.9.18，which python指向~/.pyenv/shims/python，而非/usr/bin/python3
用 venv 创建项目级依赖隔离，拒绝全局 pip
即使解释器版本已隔离，不同项目仍需各自独立的包空间。venv 是 Python 3.3+ 内置模块，轻量、标准、无额外依赖：
- 进入项目根目录后运行：
python -m venv .venv（注意空格和点号，生成隐藏文件夹） - 激活：
source .venv/bin/activate，终端提示符前出现(.venv)即生效 - 此时
which python和which pip都指向.venv/bin/下路径；pip list仅显示本环境包 - 务必先升级 pip：
pip install --upgrade pip，再安装项目所需包；导出依赖：pip freeze > requirements.txt
VS Code 与终端必须同步识别虚拟环境
IDE 不会自动继承你在终端里激活的 venv，必须手动指定解释器路径，否则代码补全、调试、导入都会错乱：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 在 VS Code 中按
Cmd+Shift+P，输入 “Python: Select Interpreter” - 从列表中选择路径类似
./.venv/bin/python的选项（注意是当前项目内的相对路径） - 右下角状态栏会显示该路径；重启集成终端，它会自动激活对应 venv
- 切记：如果看到解释器路径含
/usr/bin/或/opt/homebrew/bin/，说明没选对，需重新选择
常见错误与规避方式
很多环境问题其实源于几个简单但高频的操作失误：
立即学习“Python免费学习笔记（深入）”；
- 直接运行
pip install而未先source .venv/bin/activate→ 包被装进系统或用户 site-packages，导致 ImportError - 误删
.venv后未重建就运行代码 → 缺少依赖，报错信息模糊 - VS Code 解释器选错（如选了系统 Python 或其他项目的 venv）→ 类型提示失效、断点不触发、import 报红
- 把
.venv提交到 Git → 占用大量空间且无法跨平台复现；务必确认.venv/已加入项目.gitignore
