# 使用 Homebrew, apt 安装 virtualenvwrapper

查看 virtualenvwrapper 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:virtualenvwrapper
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install virtualenvwrapper
```

  证据: local Homebrew formula metadata

### Linux

- Debian apt (92%):

```sh
sudo apt install virtualenvwrapper
```

  证据: Debian stable package indexes: virtualenvwrapper from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

## 软件包事实

- **软件包键:** brew:virtualenvwrapper
- **软件包管理器:** Homebrew
- **版本:** 6.1.1
- **来源摘要:** Python virtualenv extensions
- **主页:** <https://virtualenvwrapper.readthedocs.io/>
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- virtualenvwrapper.sh (别名)
- virtualenvwrapper_lazy.sh (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 6.1.1
## 项目历史与用法

virtualenvwrapper is Doug Hellmann's shell layer around Ian Bicking's virtualenv. It collects virtual environments in one place and adds commands such as `mkvirtualenv`, `rmvirtualenv`, and `workon`, plus tab completion, hooks, and plugins for people who manage many Python projects from a Bourne-compatible shell.

### 项目历史

Hellmann introduced the idea publicly in a May 2008 Python Magazine article, explaining that he had been using virtualenv for all projects but that keeping track of many environments had become messy. The solution was a set of bash functions that wrapped virtualenv and made switching, creating, and cleaning environments routine.

The project documentation copyright and changelog history begin in the 2009 era, and the stable changelog records a 1.0 entry as the first copy and start of the new project. Over the 2.x through 4.x lines, virtualenvwrapper accumulated the conventions that made it recognizable: WORKON_HOME, project directories, pre/post activation hooks, and a plugin system.

The 5.x and 6.x era reflects the long tail of Python packaging change. The current documentation warns that 5.x requires virtualenv 20+, while the 6.x releases moved the project forward with refreshed packaging while preserving the shell-first model.

### 采用历史

virtualenvwrapper became a common recommendation for Python developers who lived in bash or zsh and worked on many projects at once. It did not replace virtualenv; it standardized the human workflow around virtualenv by making environment names, activation, deletion, and per-project hooks memorable.

Its influence is visible in later tools and ports. virtualenvwrapper-win brought the idea to Windows batch scripts, while VirtualFish and other shell-specific managers borrowed the model for shells that did not use Bourne-compatible activation syntax.

### 使用方式

A typical setup defines WORKON_HOME, sources `virtualenvwrapper.sh` from a shell startup file, then uses `mkvirtualenv NAME` to create an environment and `workon NAME` to switch back to it. Hooks such as preactivate, postactivate, predeactivate, and postdeactivate let users automate per-environment shell state.

The package is mostly a workflow tool rather than a runtime dependency. It matters on developer machines, CI bootstrap scripts, and old-but-still-working Python development setups where quick environment switching is more valuable than a project-level lockfile system.

### 为什么软件包爱好者会关心

virtualenvwrapper is historically important because it turned virtualenv from a command you remembered into a workspace model. For package people, `workon` and WORKON_HOME became shorthand for the pre-Poetry, pre-uv period of Python environment management: practical shell glue that solved the daily mess.

### 时间线

- 2008-05: Doug Hellmann published an article describing wrappers around virtualenv.
- 2009: virtualenvwrapper documentation and changelog history begin around the early project era.
- 2010: PyPI release history visible today includes 2.5.3 uploads.
- 2023: virtualenvwrapper 6.0.0 refreshed the project for modern packaging.
- 2024: virtualenvwrapper 6.1.1 was released.

### Related projects

- virtualenv is the underlying environment creator. virtualenvwrapper-win is a Windows port of the same idea. VirtualFish adapts similar virtualenv-management ergonomics to the fish shell.

### 来源

- Doug Hellmann's original virtualenvwrapper article: https://doughellmann.com/posts/virtualenvwrapper/
- virtualenvwrapper 6.0.0 release note: https://doughellmann.com/releases/virtualenvwrapper-6-0-0/
- virtualenvwrapper GitHub README: https://github.com/python-virtualenvwrapper/virtualenvwrapper
- virtualenvwrapper PyPI project: https://pypi.org/project/virtualenvwrapper/
- virtualenvwrapper documentation: https://virtualenvwrapper.readthedocs.io/
- virtualenvwrapper stable changelog: https://virtualenvwrapper.readthedocs.io/en/stable/history.html


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: shell startup file that sources virtualenvwrapper.sh, for example ~/.bashrc, ~/.profile
## 其他软件包管理器记录

- Debian apt - python3-virtualenvwrapper - 4.8.4-4: normalized package name match | Debian stable package indexes: python3-virtualenvwrapper from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | extension to virtualenv for managing multiple environments (Py3) | https://virtualenvwrapper.readthedocs.io/en/latest/
- Debian apt - virtualenvwrapper - 4.8.4-4: normalized package name match | Debian stable package indexes: virtualenvwrapper from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | extension to virtualenv for managing multiple environments | https://virtualenvwrapper.readthedocs.io/en/latest/
- Debian apt - virtualenvwrapper-doc - 4.8.4-4: normalized package name match | Debian stable package indexes: virtualenvwrapper-doc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | extension to virtualenv for managing multiple environments (docs) | https://virtualenvwrapper.readthedocs.io/en/latest/
- Ubuntu apt - python3-virtualenvwrapper - 4.8.4-4ubuntu1: normalized package name match | Ubuntu 24.04 LTS package indexes: python3-virtualenvwrapper from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | extension to virtualenv for managing multiple environments (Py3) | https://virtualenvwrapper.readthedocs.io/en/latest/
- Ubuntu apt - virtualenvwrapper - 4.8.4-4ubuntu1: normalized package name match | Ubuntu 24.04 LTS package indexes: virtualenvwrapper from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | extension to virtualenv for managing multiple environments | https://virtualenvwrapper.readthedocs.io/en/latest/
- Ubuntu apt - virtualenvwrapper-doc - 4.8.4-4ubuntu1: normalized package name match | Ubuntu 24.04 LTS package indexes: virtualenvwrapper-doc from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | extension to virtualenv for managing multiple environments (docs) | https://virtualenvwrapper.readthedocs.io/en/latest/


## Combined YAML source

View the package source record on GitHub. [combined/virtualenvwrapper.yml](https://github.com/mxcl/pkgdb/blob/main/combined/virtualenvwrapper.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph