venv-manager

SKILL.md

Python 虚拟环境管理器

用于管理 Python 虚拟环境的指南和工具。

何时使用

  • 技能需要安装 Python 依赖时
  • 执行需要隔离环境的 Python 脚本时
  • 避免全局 Python 环境被污染
  • 多个项目需要不同版本的依赖时

快速开始

# 1. 创建虚拟环境
python scripts/create-venv.py <path> [--python <version>]

# 2. 激活虚拟环境
source scripts/activate-venv.sh <path>

# 3. 安装依赖
pip install -r requirements.txt

工作流程

  1. 检查现有虚拟环境

    • 检查 .venv/venv/ 目录是否存在
    • 检查 .venv_path 文件中的路径
  2. 创建虚拟环境(如需要)

    python scripts/create-venv.py <path>
    
  3. 激活虚拟环境

    source scripts/activate-venv.sh <path>
    # 或使用 Python API
    python scripts/activate-venv.py --activate <path>
    
  4. 在虚拟环境中执行命令

    • 所有 pip install 应在激活后执行
    • 所有 Python 脚本应在激活后运行
  5. 清理(可选)

    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 常见问题解决方案
Weekly Installs
1
First Seen
2 days ago
Installed on
amp1
trae1
trae-cn1
opencode1
cursor1
kimi-cli1