最推荐使用python 3.3+内置venv模块：先确认python3路径和venv可用性，再cd项目目录执行python3 -m venv .venv创建，source .venv/bin/activate激活，pip安装包并导出requirements.txt，deactivate退出，vscode需手动选择./.venv/bin/python解释器。
在 macos 上配置 python 虚拟环境，最推荐的方式是使用 python 3.3+ 内置的 venv 模块——它轻量、标准、无需额外安装，每个项目独享解释器和包，彻底避免依赖冲突。
确认 Python 和 venv 是否可用
打开终端，执行以下检查：
- 运行 which python3，确认返回路径（如
/opt/homebrew/bin/python3或/usr/local/bin/python3），避免使用系统自带的/usr/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 命令只作用于当前项目：
-
激活：
source .venv/bin/activate，终端提示符前会显示(.venv) -
验证：
which python应返回./.venv/bin/python；which pip同理 -
安装依赖：先升级 pip（
pip install --upgrade pip），再装所需包（如pip install requests flask） -
导出依赖清单：
pip freeze > requirements.txt，便于协作或重建环境 -
退出：
deactivate，提示符恢复原状，但.venv文件夹仍保留，下次可重新激活
VSCode 中正确识别虚拟环境
VSCode 不会自动激活终端里的虚拟环境，需手动指定解释器：
- 按 Cmd+Shift+P，输入
Python: Select Interpreter - 在列表中选择路径类似
./.venv/bin/python的选项（注意是项目内路径） - 重启集成终端（或关闭再打开），此时终端也会自动激活该环境
- 编辑器右下角会显示当前解释器路径，确保它指向
.venv而非系统 Python
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
