在Mac上为每个Python项目搭建独立虚拟环境，是为了避免依赖冲突、防止污染系统Python、绕过PEP 668限制；必须使用非系统Python（如Homebrew安装）、用python3 -m venv .venv创建隐藏环境、激活后验证which python和pip list确保隔离，并通过pip install --upgrade pip及pip freeze > requirements.txt规范管理依赖。
在Mac上为每个Python项目搭建独立虚拟环境，是为了彻底避免不同项目间依赖包版本冲突、防止误装包污染系统Python、绕过macOS的PEP 668权限限制。你不能直接在系统Python或Homebrew Python上用pip install，否则会遇到“externally-managed-environment”报错或PermissionError。
确认Python和venv可用性
打开终端，先检查当前python3是否来自Homebrew或自定义安装路径，而非系统自带的/usr/bin/python3：
运行 which python3，正常应返回类似 /opt/homebrew/bin/python3 或 /usr/local/bin/python3。
若显示 /usr/bin/python3，请勿在此路径下创建环境——它受SIP保护，venv虽能创建，但后续pip操作大概率失败。
再运行 python3 -m venv --help，看到帮助信息即说明venv模块就绪；若提示 【No module named venv】，说明该Python未启用标准库venv，需重装（如用Homebrew执行 brew reinstall python）。
为项目创建.venv虚拟环境
进入你的项目根目录：cd /path/to/your/project
执行命令创建隐藏命名的虚拟环境：python3 -m venv .venv
这一步会在当前目录生成 .venv/ 文件夹，含 bin/、lib/、include/ 等子目录。
【必须用点号开头（.venv），而非venv】：既符合行业惯例，又默认被Git忽略，且VS Code、PyCharm等主流编辑器能自动识别；若命名为venv，易被误提交至仓库，也易在Finder中被手滑删除。
激活并验证隔离状态
方法一：手动激活
运行 source .venv/bin/activate，终端提示符前应立即出现 (.venv) 前缀。
验证是否真正隔离：
执行 which python，输出必须是 ./.venv/bin/python；
执行 pip list，结果应仅含 pip、setuptools、wheel 三个基础包——这是干净隔离的铁证。
若 pip list 显示大量第三方包，说明你没激活成功，或激活后又开了新终端窗口却忘了再次激活。
立即学习“Python免费学习笔记（深入）”；
方法二：配合direnv自动激活（可选进阶）
先安装 brew install direnv，并在 ~/.zshrc 中添加 eval "$(direnv hook zsh)" 并执行 source ~/.zshrc。
在项目根目录下创建 .envrc 文件，写入一行：source .venv/bin/activate。
首次进入目录时运行 direnv allow，之后每次 cd 进该项目，环境自动激活，离开即退出。
安装依赖与导出清单
第一步：升级pippip install --upgrade pip
这步不能跳过——旧版pip在macOS上对某些包（如numpy、torch）的wheel匹配逻辑有缺陷，容易安装失败或降级。
第二步：安装项目所需包pip install requests flask python-dotenv
所有包将严格安装到 .venv/lib/python*/site-packages/ 内，与系统和其他项目完全无关。
第三步：导出依赖快照pip freeze > requirements.txt
生成的文件记录当前环境全部包名与精确版本，供协作或CI重建使用；注意不要手动编辑此文件，也不要删掉注释行（如 # Editable install with no version control），否则 pip install -r requirements.txt 可能静默跳过某些包。
