最推荐使用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 命令只作用于当前项目：

python全能编程助手

SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、

下载

• 激活：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 不会自动激活终端里的虚拟环境，需手动指定解释器：

立即学习“Python免费学习笔记（深入）”；

• 按 Cmd+Shift+P，输入 Python: Select Interpreter
• 在列表中选择路径类似 ./.venv/bin/python 的选项（注意是项目内路径）
• 重启集成终端（或关闭再打开），此时终端也会自动激活该环境
• 编辑器右下角会显示当前解释器路径，确保它指向 .venv 而非系统 Python