在 macOS 上用 venv 搭建虚拟环境是最轻量、最标准、也最推荐的方式，直接调用 Python 3.3+ 内置模块，通过 python3 -m venv .venv 创建、source .venv/bin/activate 激活、deactivate 退出，实现项目级依赖隔离。
在 macOS 上用 venv 搭建虚拟环境是最轻量、最标准、也最推荐的方式。它不依赖第三方工具，直接调用 Python 3.3+ 内置模块，每个项目独享一套解释器和包，彻底避免依赖冲突。
确认 Python 和 venv 可用
打开终端，先检查系统是否已具备可用的 Python 3 和 venv 模块：
- 输入
which python3，确认返回路径（如/usr/bin/python3或/opt/homebrew/bin/python3） - 运行
python3 -m venv --help，若正常显示帮助信息，说明 venv 已就绪 - 如果提示
No module named venv，说明当前 Python 不支持（极少见），建议用 Homebrew 重装：brew install python
为项目创建独立虚拟环境
进入你的项目根目录后执行：
-
python3 -m venv .venv—— 推荐用.venv（带点号）命名，既符合惯例，又方便被 Git 自动忽略 - 命令执行完成后，当前目录下会出现
.venv/文件夹，含bin/、lib/、include/等子目录 - 把
.venv加入项目.gitignore，避免误提交
激活、使用与退出环境
激活后所有 python 和 pip 命令都只作用于当前项目：
立即学习“Python免费学习笔记（深入）”；
- 激活：
source .venv/bin/activate，终端提示符前会显示(.venv) - 验证：
which python应返回./.venv/bin/python；which pip同理 - 安装依赖：
pip install --upgrade pip（先升级 pip），再装所需包，如pip install requests flask - 导出依赖清单：
pip freeze > requirements.txt，便于协作或重建环境 - 退出：
deactivate，提示符恢复原状，但.venv文件夹仍保留，下次可重新激活
VSCode 中正确识别虚拟环境
VSCode 不会自动激活终端里的虚拟环境，需手动指定解释器：
- 按
Cmd+Shift+P，输入Python: Select Interpreter - 在列表中选择路径类似
./.venv/bin/python的选项（注意是项目内路径） - 重启集成终端（或关闭再打开），此时终端也会自动激活该环境
- 编辑器右下角会显示当前解释器路径，确保它指向
.venv而非系统 Python
