| name | venv-manager |
| description | 自动管理 Python 虚拟环境。当其他技能需要隔离的 Python 环境时,本技能帮助 AI 创建、激活和管理虚拟环境,确保依赖不冲突。 |
Python 虚拟环境管理器
用于管理 Python 虚拟环境的指南和工具。
何时使用
- 技能需要安装 Python 依赖时
- 执行需要隔离环境的 Python 脚本时
- 避免全局 Python 环境被污染
- 多个项目需要不同版本的依赖时
快速开始
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 scripts/activate-venv.py --activate <path>
-
在虚拟环境中执行命令
- 所有 pip install 应在激活后执行
- 所有 Python 脚本应在激活后运行
-
清理(可选)
python scripts/cleanup-venv.py <path>
参考文件
| 文件 | 用途 |
|---|
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 | 常见问题解决方案 |