正确做法是用shell函数而非alias激活venv，因alias执行source会在子shell中运行导致父shell环境不变；需定义函数如work(){ source /path/.venv/bin/activate; }并写入~/.bashrc或~/.zshrc，路径必须为绝对路径。

用 shell 别名快速激活 venv

直接给 venv 起“别名”在 Python 层面做不到，但你真正需要的其实是：输入一个简短命令（比如 work）就自动激活指定虚拟环境。这靠 shell 的 alias 就能实现，但必须注意路径和作用域问题。

常见错误是写成 alias work="source /path/to/venv/bin/activate"，看似可行，实际执行后 shell 会退出激活状态——因为 source 在子 shell 中运行，父 shell 环境没变。

• 正确做法是 alias 指向一个函数，或直接用 source + 绝对路径（bash/zsh 下支持）
• 推荐定义函数（更可靠，可加判断）：

  work() {
      source /your/project/.venv/bin/activate
  }

• 把函数写进 ~/.bashrc 或 ~/.zshrc，然后 source ~/.zshrc
• 路径务必写绝对路径，相对路径在任意目录下执行会失败

用 direnv 自动激活（推荐长期项目）

如果你总在某个项目目录下工作，direnv 是比 alias 更智能的方案：进入目录时自动激活 venv，离开时自动退出。

A Python CLI skill for Cutout.Pro visual APIs — background removal, face cutout, and photo enhancement. Supports file upload & image URL input.

调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强，支持文件上传与图片 URL 输入。

下载

• 先安装：brew install direnv（macOS）或 apt install direnv（Ubuntu）
• 在 shell 配置里加载：echo 'eval "$(direnv hook zsh)"' >> ~/.zshrc
• 在项目根目录创建 .envrc，内容为：

  layout python3
  use python /your/project/.venv

  （前提是已用 python -m venv .venv 创建过）
• 首次进入目录会提示 direnv: disallowed changes to .envrc，运行 direnv allow 即可

避免 alias 激活后无法 deactivate 的坑

用 alias 或函数激活 venv 后，deactivate 依然可用，但要注意它只对当前 shell 生效；如果误开新终端，deactivate 就找不到上下文。

立即学习“Python免费学习笔记（深入）”；

• 别在 alias 里写 deactivate && source ... —— deactivate 在未激活时会报错 bash: deactivate: command not found
• 函数中可加防护：

  work() {
      type deactivate >/dev/null 2>&1 && deactivate 2>/dev/null
      source /your/project/.venv/bin/activate
  }

• 激活后检查：which python 应该指向 venv 内的路径，echo $VIRTUAL_ENV 应非空

Windows PowerShell 怎么办

PowerShell 默认禁用脚本执行，直接 alias 会失败，得换方式。

• 不能用传统 alias，改用函数：

  function work { & "C:\path\to\venv\Scripts\Activate.ps1" }

• 先运行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 允许本地脚本
• 把函数加到 $PROFILE（用 notepad $PROFILE 编辑）
• 注意 PowerShell 的 activate 脚本是 .ps1，不是 activate 或 activate.bat

实际最常被忽略的是：venv 路径写错、shell 配置没重载、PowerShell 策略限制没开——这三个点卡住的人最多。