一、参考资料

virtualenv
virtualenv简单使用
virtualenv的介绍及基本使用（所有命令解释）
python虚拟环境 + 批量pip + 换源

二、相关介绍

irtualenv通过创建一个虚拟化的python运行环境，将我们所需的依赖安装进去的，便于不同的项目在同一台机器上开发运行，不同项目之间相互不干扰，即在一台机器上创建多个独立的python运行环境。如下所示：

使用 VirtualEnv 的理由：

• 隔离项目之间的第三方包依赖，如A项目依赖django1.2.5，B项目依赖django1.3。
• 为部署应用提供方便，把开发环境的虚拟环境打包到生产环境即可,不需要在服务器上再折腾一翻。

三、重要说明

1. pyhon2安装的virtualenv虚拟化出来的python运行环境是python2的，python3安装的virtualenv默认虚拟化环境则是python3的。
2. 不能使用root（sudo）权限安装包，比如sudo pip。
3. virtualenv更多的还是适用于本地开发不同的项目，但是在生产环境中还是使用docker给不同的项目创建不同的容器，各自分开运行为好，不宜放在一个单独的物理机中运行。

四、基本操作

1. 安装virtualenv

   方法一：pip安装

   pip install virtualenv（推荐）
   或者
   sudo apt-get install virtualenv（不推荐，更新不方便）
   

   ​ 方法二：源码安装
   ​ 下载virtualenv源码package，通过执行setup.py来安装virtualenv。

2. 创建虚拟环境
   新建的Python环境被放到当前目录下的venv目录

   virtualenv venv
   

   （推荐）创建虚拟环境（继承系统环境）

   virtualenv --system-site-packages venv
   

   创建干净的虚拟环境（默认）

   # 可能失效
   virtualenv --no-site-packages venv
   或者
   virtualenv venv
   

   注：参数–no-site-packages，安装到系统Python环境中的所有第三方包都不会复制过来，得到了一个不带任何第三方包的“干净”的Python运行环境

3. 指定python版本，默认使用的是当前系统安装(/usr/bin/python)的python解释器

   # python2的环境
   virtualenv -p /usr/bin/python venv
   
   # python3的环境 
   virtualenv -p /usr/bin/python3 venv
   

4. 激活虚拟环境

   source venv/bin/activate
   

5. 退出虚拟环境

   deactivate
   

6. 删除虚拟环境，删除venv文件夹即可

   sudo rm -rf venv
   

7. 安装软件包

   pip install numpy
   

8. 安装requirements.txt依赖包

   pip install -r requirements.txt
   

9. 生成requirements.txt依赖包

   pip freeze > requirements.txt
   

10. 其他参数

    用法:
    virtualenv [OPTIONS] DEST_DIR
    
    选项:
    –version:显示当前版本号。
    -h, –help:显示帮助信息。
    -v, –verbose:显示详细信息。
    -q, –quiet:不显示详细信息。
    -p PYTHON_EXE, –python=PYTHON_EXE指定所用的python解析器的版本，比如 –python=python2.5 就使用2.5版本的解析器创建新的隔离环境。 默认使用的是当前系统安装(/usr/bin/python)的python解析器。
    –clear：清空非root用户的安装，并重头开始创建隔离环境。
    –no-site-packages：令隔离环境不能访问系统全局的site-packages目录。
    –system-site-packages：令隔离环境可以访问系统全局的site-packages目录。
    –unzip-setuptools：安装时解压Setuptools或Distribute。
    –relocatable：重定位某个已存在的隔离环境。使用该选项将修正脚本并令所有.pth文件使用相当路径。
    –distribute：使用Distribute代替Setuptools，也可设置环境变量VIRTUALENV_DISTRIBUTE达到同样效要。
    –extra-search-dir=SEARCH_DIRS：用于查找setuptools/distribute/pip发布包的目录。可以添加任意数量的–extra-search-dir路径。
    –never-download：禁止从网上下载任何数据。此时，如果在本地搜索发布包失败，virtualenv就会报错。
    –prompt==PROMPT：定义隔离环境的命令行前缀。
    

11. Pycharm中，直接创建virtualenv虚拟环境
    

五、虚拟环境复制迁移

1. 拷贝 venv 虚拟环境文件夹

   # 如果是服务器中
   # 1. 压缩文件
   tar -zcvf venv.tar.gz ./venv
   
   # 2. 解压文件
   tar -zxvf xxx.tar.gz
   

2. 修改 venv/bin/activate 文件中的参数：

   VIRTUAL_ENV="/home/venv"

   将 VIRTUAL_ENV 路径改为当前 venv文件夹的路径

3. 激活虚拟环境

   source ./venv/bin/activate

4. 查看虚拟环境是否复制成功

   which python
   # 或者
   which pip
   

六、virtualenvwrapper

python虚拟环境–virtualenv

virtualenv缺点
因为virtual的启动、停止脚本都在特定文件夹（在项目目录里的venv文件夹），可能一段时间后，你可能会有很多个虚拟环境散落在系统各处，你可能忘记它们的名字或者位置。

virtualenvwrapper的优点
鉴于virtualenv不便于对虚拟环境集中管理，所以推荐直接使用 virtualenvwrapper。 virtualenvwrapper提供了一系列命令使得和虚拟环境工作变得便利，它把你所有的虚拟环境都放在一个地方。

安装virtualenvwrapper之前，确保virtualenv已安装。

关键步骤

1. 安装virtualenvwrapper

   pip install virtualenvwrapper
   

2. 设置配置文件，并更新配置

   sudo gedit ~/.bash
   export WORKON_HOME=~/Envs
   source /usr/local/bin/virtualenvwrapper.sh
   source ~/.bashrc
   
   说明：
   第二行：virtualenvwrapper存放虚拟环境目录，新建的虚拟环境都会存在该目录中。
   第三行：virtrualenvwrapper会安装到python的bin目录下，所以该路径是python安装目录下。
   

3. 创建虚拟环境

   mkvirtualenv venv
   

4. 指定python版本，默认使用的是当前系统安装(/usr/bin/python)的python解释器

   mkvirtualenv --python=/usr/bin/python3 venv
   

5. 当前的虚拟环境目录

   workon
   

6. 切换虚拟环境

   workon py3
   

7. 退出虚拟环境

   deactivate
   

8. 删除虚拟环境

   rmvirtualenv venv
   

七、可能出现的问题

Q1：创建虚拟环境失败

Traceback (most recent call last):
  File "/usr/bin/virtualenv", line 11, in <module>
    load_entry_point('virtualenv==15.1.0', 'console_scripts', 'virtualenv')()
  File "/usr/lib/python3/dist-packages/virtualenv.py", line 724, in main
    symlink=options.symlink)
  File "/usr/lib/python3/dist-packages/virtualenv.py", line 992, in create_environment
    download=download,
  File "/usr/lib/python3/dist-packages/virtualenv.py", line 922, in install_wheel
    call_subprocess(cmd, show_stdout=False, extra_env=env, stdin=SCRIPT)
  File "/usr/lib/python3/dist-packages/virtualenv.py", line 817, in call_subprocess
    % (cmd_desc, proc.returncode))
OSError: Command /media/mydisk/MyDocu...det/venv/bin/python3 - setuptools pkg_resources pip wheel failed with error code 2

----------------------------------------
...Installing setuptools < 51.3, pkg_resources, pip < 21, wheel...done.
Traceback (most recent call last):
  File "/usr/bin/virtualenv", line 9, in <module>
    load_entry_point('virtualenv==15.0.1', 'console_scripts', 'virtualenv')()
  File "/usr/lib/python3/dist-packages/virtualenv.py", line 719, in main
    symlink=options.symlink)
  File "/usr/lib/python3/dist-packages/virtualenv.py", line 991, in create_environment
    download=download,
  File "/usr/lib/python3/dist-packages/virtualenv.py", line 918, in install_wheel
    call_subprocess(cmd, show_stdout=False, extra_env=env, stdin=SCRIPT)
  File "/usr/lib/python3/dist-packages/virtualenv.py", line 812, in call_subprocess
    % (cmd_desc, proc.returncode))
OSError: Command /home/yoyo/MyDocumen...pth/venv/bin/python3 - "setuptools < 51.3" pkg_resources "pip < 21" wheel failed with error code 2

错误原因：
virtualenv与python版本不匹配
博主安装virtualenv的方式是apt-get方式，导致virtualenv版本无法更新

解决方法：
卸载virtualenv，使用pip方式安装
sudo apt-get --purge remove virtualenv
sudo apt-get autoremove
sudo apt-get autoclean

pip方式重新安装
pip install virtualenv

Q2：找不到virtualenv

tx2@tx2:~/Desktop/20220113$ virtualenv -p /usr/bin/python3 venv
bash: /usr/bin/virtualenv: No such file or directory

错误原因：
博主在jetson tx2中用pip3安装virtualenv，安装的路径不是系统默认路径。

解决办法：
1. 查找virtualenv的路径
locate virtualenv
输出：
/home/tx2/.local/bin/virtualenv

2. 创建软链接
sudo ln -s /home/tx2/.local/bin/virtualenv /usr/bin/virtualenv

3. 测试是否成功
virtualenv --version