用途
venv-manager 是一个 Python 虚拟环境管理器,用于管理 Python 虚拟环境的指南和工具。当其他技能需要隔离的 Python 环境时,本技能帮助 AI 创建、激活和管理虚拟环境,确保依赖不冲突。
何时使用
- 技能需要安装 Python 依赖时
- 执行需要隔离环境的 Python 脚本时
- 避免全局 Python 环境被污染
- 多个项目需要不同版本的依赖时
主要能力
本技能提供以下脚本与参考文件:
- scripts/create-venv.py:创建新的虚拟环境
- scripts/activate-venv.py:激活虚拟环境(Python API)
- scripts/activate-venv.sh:激活虚拟环境(Shell 脚本)
- scripts/cleanup-venv.py:清理/删除虚拟环境
- references/venv-guide.md:虚拟环境管理最佳实践
- references/common-issues.md:常见问题解决方案
使用方式
快速开始:
- 创建虚拟环境
python scripts/create-venv.py <path> [--python <version>]
- 激活虚拟环境
source scripts/activate-venv.sh <path>
- 安装依赖
pip install -r requirements.txt
工作流程:
-
检查现有虚拟环境
- 检查
.venv/或venv/目录是否存在 - 检查
.venv_path文件中的路径
- 检查
-
创建虚拟环境(如需要)
python scripts/create-venv.py <path>
- 激活虚拟环境
source scripts/activate-venv.sh <path>
# 或使用 Python API
python scripts/activate-venv.py --activate <path>
-
在虚拟环境中执行命令
- 所有 pip install 应在激活后执行
- 所有 Python 脚本应在激活后运行
-
清理(可选)
python scripts/cleanup-venv.py <path>
适用场景
- 需要安装 Python 依赖的技能
- 需要隔离环境执行 Python 脚本
- 避免全局 Python 环境被污染
- 多个项目需要不同版本的依赖
限制
关于本技能的具体限制、支持的 Python 版本范围、平台兼容性等信息,资料中暂未提供。