如何在MacOS上安装并配置Python的virtualenv与virtualenvwrapper

Hey folks, let’s walk through how to set up virtualenv and virtualenvwrapper on macOS for your Python projects—these tools are total lifesavers for keeping project dependencies isolated, so you won’t run into "why does this package work in one project but not another?" headaches.

一、先确认你的Python环境 #

macOS自带Python，但通常更推荐用Homebrew安装的灵活版本。先检查一下：

• 打开终端，运行 python3 --version 查看是否已安装Python3。
• 如果没装，先安装Homebrew（macOS开发者必备工具）：

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  

  接着安装Python：

  brew install python
  

二、安装virtualenv #

virtualenv是创建独立Python环境的核心工具，用pip3直接安装：

pip3 install virtualenv

验证安装成功：运行 virtualenv --version，能看到版本号就说明没问题。

三、安装virtualenvwrapper #

virtualenvwrapper是virtualenv的增强工具，能让环境管理更省心（不用记一堆文件夹路径），同样用pip3安装：

pip3 install virtualenvwrapper

四、配置环境变量（这步很关键！） #

要让终端识别virtualenvwrapper的命令，得修改你的shell配置文件：

1. 先确认你用的shell类型：终端输入 echo $SHELL，如果输出是/bin/zsh就修改~/.zshrc，如果是/bin/bash就修改~/.bash_profile或~/.bashrc。
2. 打开配置文件，比如zsh用户可以运行：

   open -e ~/.zshrc
   

3. 在文件末尾添加以下内容（用自动路径匹配，避免手动填错）：

   # Virtualenvwrapper 配置
   export WORKON_HOME=$HOME/.virtualenvs  # 所有虚拟环境会存在这个目录下
   export VIRTUALENVWRAPPER_PYTHON=$(which python3)  # 自动匹配你的Python3路径
   source $(which virtualenvwrapper.sh)  # 加载virtualenvwrapper脚本
   

4. 保存文件后，让配置立即生效：

   source ~/.zshrc  # 对应你的配置文件，比如bash用户用source ~/.bash_profile
   

五、常用命令（终于可以用啦！） #

现在你可以顺畅管理虚拟环境了：

• 创建新环境：mkvirtualenv my_cool_project（替换成你的项目名），创建后会自动进入该环境。
• 查看所有环境：lsvirtualenv
• 切换到某个环境：workon my_cool_project
• 退出当前环境：deactivate
• 删除不需要的环境：rmvirtualenv my_cool_project

小提示 #

如果需要给环境指定特定Python版本（虽然Python2已淘汰，但偶尔可能用到），可以这样：

mkvirtualenv -p python2.7 old_legacy_project

内容的提问来源于stack exchange，提问作者Stan Reduta