Ubuntu 22 Python 虚拟环境配置

首先下载 Ubuntu 系统的 virtualenv 依赖:

$ sudo apt install virtualenv

因为 Ubuntu 22 默认的版本刚好是我需要的 Python 3.10 版本, 这里就不安装其他版本了。

日常使用 virtualenvwrapper 的命令:

• 创建新的虚拟环境

  $ mkvirtualenv -p Python版本号 虚拟环境名称
  

• 查看已创建的虚拟环境

  $ lsvirtualenv
  

• 进入指定的虚拟环境

  $ workon 虚拟环境名称
  

• 退出当前虚拟环境

  $ deactivate
  

• 删除指定的虚拟环境

  $ rmvirtualenv 虚拟环境名称
  

安装 virtualenvwrapper

通过 pip 安装 virtualenv 和 virtualenvwrapper 库:

$ pip install virtualenv
$ pip install virtualenvwrapper

在 用户根目录(cd ~) 下创建 .virtualenvs 文件夹:

$ cd ~
$ pwd
/home/ubuntu
mkdir .virtualenvs

这个文件夹是用来保存用户创建的所有 Python 虚拟环境的。

查看 virtualenvwrapper.sh 所在的目录, 用于接下来设置打开终端自动启用 virtualenvwrapper 命令:

$ sudo find / -name virtualenvwrapper.sh
/home/ubuntu/.local/bin/virtualenvwrapper.sh

修改当前用户的 .bashrc 配置文件:

$ vim ~/.bashrc

并在 .bashrc 配置文件的最后添加两行配置:

# 设置 virtualenvwrapper 虚拟环境保存的目录
export WORKON_HOME=/home/ubuntu/.virtualenvs
# 设置 virtualenvwrapper 默认的 python 版本
export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3
# 打开终端自动启用 virtualenvwrapper 命令
source /home/ubuntu/.local/bin/virtualenvwrapper.sh

最后将上面的修改立即生效:

$ source ~/.bashrc

使用 virtualenvwrapper

使用系统环境中的 Python 3.10 来创建新建一个虚拟的 test_venv 环境:

$ mkvirtualenv -p python3.10 test_venv
created virtual environment CPython3.10.12.final.0-64 in 187ms
  creator CPython3Posix(dest=/home/ubuntu/.virtualenvs/test_venv, clear=False, no_vcs_ignore=False, global=False)
  seeder FromAppData(download=False, pip=bundle, setuptools=bundle, wheel=bundle, via=copy, app_data_dir=/home/ubuntu/.local/share/virtualenv)
    added seed packages: pip==23.2.1, setuptools==68.2.0, wheel==0.41.2
  activators BashActivator,CShellActivator,FishActivator,NushellActivator,PowerShellActivator,PythonActivator
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/test_venv/bin/predeactivate
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/test_venv/bin/postdeactivate
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/test_venv/bin/preactivate
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/test_venv/bin/postactivate
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/test_venv/bin/get_env_details

创建成功后会自动进入 test_venv 环境, 先使用 deactivate 命令退出当前虚拟环境:

(test_venv) ubuntu@VM-4-14-ubuntu:~$ deactivate
ubuntu@VM-4-14-ubuntu:~$

然后再执行 lsvirtualenv 指令查看目前已经创建的所有 Python 虚拟环境:

$ lsvirtualenv
test_venv
=========

之后就可以在任意目录下激活虚拟环境 test_venv 进行开发调试:

ubuntu@VM-4-14-ubuntu:~/code$ workon test_venv
(test_venv) ubuntu@VM-4-14-ubuntu:~/code$

在 VS Code 中使用

进入工作环境设置文件 settings.json 并加入以下配置:

"python.venvPath": "/home/ubuntu/.virtualenvs"

然后重启 VS Code 就可以看到已经配置成功并被识别, 可以选择所有已经创建的 Python 虚拟环境。