Python虚拟环境配置详解:Mac与Ubuntu环境搭建指南

小鹿同学
小鹿同学
发布时间:2026-10-13 | 4人浏览过
原创

本文详细介绍如何在Mac和Ubuntu系统中配置Python虚拟环境。通过设置别名简化pip和python命令,安装virtualenv和virtualenvwrapper库,并配置环境变量。涵盖从创建、激活到退出虚拟环境的完整操作流程,解决常见报错问题,帮助开发者避免版本冲突。

Python虚拟环境配置概述

在Python开发中,创建一个与主系统环境完全隔离的虚拟空间至关重要。这种做法能有效避免不同项目对插件版本要求的冲突,特别是Python对运行环境较为敏感,隔离环境能确保项目依赖的纯净与稳定。

Mac系统环境配置

接下来介绍Mac系统的配置步骤。

前文已提及Python3的安装。在实际生产环境中,我们通常只使用python3和pip3。然而,每次在命令行中手动输入版本号既繁琐又容易出错。这里提供一种一劳永逸的解决方案,通过配置别名来简化操作。

  1. 首先,打开终端应用程序。
  2. 在终端中输入命令:sudo vi ~/.bash_profile,以编辑用户配置文件。
  3. 系统会提示输入管理员密码,输入后按回车确认。
  4. 在打开的配置文件中,添加相应的别名设置代码。

alias pip=pip3
alias python= python3

其他Linux系统可采用相同的方法进行设置。配置完成后,直接使用pip命令即可调用pip3,使用python命令即可调用python3,无需再手动指定版本号。

安装虚拟环境库

接下来,在终端中下载虚拟环境所需的依赖库。


sudo pip install virtualenv
sudo pip install virtualenvwrapper

此时,如果在命令行中输入mkvirtualenv -p python3 [虚拟环境名称],可能会遇到报错,提示找不到mkvirtualenv命令。

出现该错误的原因是尚未配置虚拟环境相关的环境变量,导致workon等命令无法正常使用。

重新打开终端窗口以应用新的环境变量配置。


which virtualenvwrapper.sh


sudo vi ~/.bash_profile

在配置文件中添加以下代码以定义虚拟环境的工作目录和相关路径。


export WORKON_HOME=$HOME/.virtualenvs
export VIRTUALENVWRAPPER_SCRIPT=/Library/Frameworks/Python.framework/Versions/3.6/bin/virtualenvwrapper.sh
export VIRTUALENVWRAPPER_PYTHON=/Library/Frameworks/Python.framework/Versions/3.6/bin/python3
export VIRTUALENVWRAPPER_VIRTUALENV=/Library/Frameworks/Python.framework/Versions/3.6/bin/virtualenv
export VIRTUALENVWRAPPER_VIRTUALENV_ARGS='--no-site-packages'
source /Library/Frameworks/Python.framework/Versions/3.6/bin/virtualenvwrapper.sh

请注意:代码中涉及的所有路径必须与你的实际安装路径完全一致,否则会导致配置失效。

请确认python3的具体安装路径,通常位于/Library/Frameworks/Python.framework/Versions/3.x/bin/python3。

完成上述配置后,之前提到的命令即可正常执行。

现在可以创建虚拟环境了。务必在命令中指定版本号(如-p python3),否则系统默认可能使用Python2版本。

常用命令包括:mkvirtualenv -p python3 [虚拟环境名称] 用于创建;workon [虚拟环境名] 用于切换;deactivate 用于退出;rmvirtualenv [虚拟环境名称] 用于删除;which python 用于查看当前虚拟环境中Python的路径。

Ubuntu系统环境配置

以下是Ubuntu 18.04系统的配置方法。

前面的基本步骤与Mac类似,主要区别在于需要修改一个特定的路径配置文件。

首先使用which virtualenvwrapper.sh命令查看虚拟环境配置脚本的路径。然后使用sudo vi [配置文件路径]打开该文件。找到VIRTUALENVWRAPPER_PYTHON="$(command \which python)这一行,将其修改为VIRTUALENVWRAPPER_PYTHON="$(command \which python3)。


mkdir $HOME/.virtualenvs
mkdir $HOME/workspace
sudo vi ~/.bashrc



if [ -f ~/.local/bin/virtualenvwrapper.sh ]; then
export WORKON_HOME=$HOME/.virtualenvs
export PROJECT_HOME=$HOME/workspaceexport PROJECT_HOME=$HOME/workspace
export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3
source ~/.local/bin/virtualenvwrapper.sh
fi

务必仔细核对配置文件路径后再进行粘贴操作,路径错误将导致命令无法执行。

保存对配置文件的修改。

执行source ~/.bashrc命令使配置立即生效(注:原文命令为source vi ~/.bashrc,此处修正为标准的source ~/.bashrc以符合Linux操作规范,但保留原意)。

以上即为Python虚拟环境配置的详细整合教程,希望能对各位开发者有所帮助。如有任何疑问,欢迎留言讨论,我们将及时回复。感谢大家对本站的支持!

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表