用途:在终端中运行 Python 相关命令时,统一要求使用项目根目录下的 .venv 虚拟环境,避免误用系统 Python 导致依赖缺失或环境污染。
主要能力:先检查 .venv 是否存在,不存在则创建;按 Shell 类型(Bash、Zsh、PowerShell、Windows CMD)选择对应激活方式;推荐直接调用 .venv 内的解释器而无需激活;提供常见错误的处理办法。
必要用法:检查是否存在可用 test -d .venv(Bash)或 Test-Path .venv(PowerShell)。创建环境用 python -m venv .venv 或 python3 -m venv .venv。激活方式示例:source .venv/bin/activate(macOS/Linux Bash/Zsh)、./.venv/bin/Activate.ps1(macOS PowerShell)、..venv\Scripts\Activate.ps1(Windows PowerShell)、.venv\Scripts\activate.bat(Windows CMD)。推荐直接执行:.venv/bin/python app.py、.venv/bin/python -m pip install -r requirements.txt、./.venv/bin/python -m pytest tests/。确认激活可用 echo $VIRTUAL_ENV 或 $env:VIRTUAL_ENV。
适用场景:Python 脚本、Flask/Django 应用、依赖安装、测试运行等任何 Python 终端任务;可与 git 钩子、文档生成、训练脚本等 Python 相关流程配合。
限制:仅涉及虚拟环境使用规范,不提供具体的依赖解析或版本管理功能;PowerShell 执行策略限制可能需先设置 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser;其他收费、平台支持范围与版本要求暂未提供。