核心用法
该技能强制要求在执行Python脚本、安装第三方包或管理项目依赖前,优先检查并复用现有的虚拟环境(.venv/venv/env/.env或conda环境)。若无现成环境,则引导用户三选一:在当前目录创建新venv(推荐)、使用系统Python直接执行,或指定自定义路径创建。
显著优点
- 依赖隔离:从根本上避免包版本冲突和系统Python污染
- 智能复用:自动检测现有环境,保留已安装包,减少重复下载
- 灵活适配:支持标准venv、uv、conda、poetry、pipenv等多种工具链
- 项目感知:通过requirements.txt、pyproject.toml、Pipfile等自动推断安装命令
- 跨平台:提供Linux/macOS/Windows全套命令对照
潜在局限
- 交互阻塞:必须等待用户选择,无法完全自动化无人值守场景
- 工具偏好未预设:未内置对uv/poetry等现代工具的优先级自动判断
- conda检测依赖外部命令:
conda info --envs需conda已安装且PATH配置正确 - 简单任务 overhead:单条标准库命令仍需走检查流程,虽有豁免但实际判断需人工
适合人群
- 多项目并行的Python开发者
- 运维/ML工程师需保证环境可复现性
- 团队新人,尚未建立venv使用习惯
- 任何使用AI辅助生成Python代码的用户(防止AI直接
pip install污染系统)
常规风险
| 风险场景 | 说明 |
|---------|------|
| 误用系统Python | 用户选择"使用系统Python"后安装包,仍可能污染系统环境 |
| 路径权限问题 | 自定义路径可能涉及无写权限的目录 |
| conda误检 | 若conda未正确配置,检测命令可能失败静默 |
| 环境未激活残留 | 脚本中若未正确source/activate,实际仍用系统Python |
缓解建议:技能已内置检测顺序和复用逻辑,关键风险在于用户的"使用系统Python"选择——建议在UI层对该选项增加二次确认或警告提示。