Python 安装与卸载完整指南
说到 Python 环境配置,安装与卸载是开发者必须掌握的第一步。本文将详细拆解 Mac 和 Windows 两大平台的主流操作方法,并分享常见陷阱与解决技巧,助你轻松上手。
Mac 环境下的 Python 安装
方式一:官方安装包下载
访问 Python 官网(https://www.python.org/),选择对应版本的 .pkg 文件下载。双击安装时,一路点击“下一步”并使用默认配置即可。安装完成后,系统会自动添加三样内容:Python 框架、Python 应用目录以及指向 Python 的软链接。

实际上,Mac 自带了 Python 环境,其框架目录位于 /System/Library/Frameworks/Python.framework。而我们手动安装的 Python,默认框架目录为 /Library/Frameworks/Python.framework。务必分清这两个路径,以免混淆。
安装完毕后,验证版本:
python --version
如需查看安装目录,可借助 Python 自身的内省能力:
import sys
print sys.path
方式二:Homebrew 安装
Homebrew 用户则更加省心,一行命令即可搞定:
brew search python # 搜索可用的 Python 版本
brew install pythonX # 安装所需版本,例如 python3.9
使用 Homebrew 安装的优势在于版本管理更灵活,后续卸载也更彻底干净。
Mac 下 Python 的卸载
在 Mac 上卸载 Python 不能简单地拖入废纸篓,必须依次清理框架、应用目录和软链接三个部分。假设要卸载 Python x.x 版本,请按以下步骤操作:
第一步,删除框架:
sudo rm -rf /Library/Frameworks/Python.framework/Versions/x.x
第二步,删除应用目录:
sudo rm -rf "/Applications/Python x.x"
第三步,清理 /usr/local/bin 下的软链接:
cd /usr/local/bin
ls -l /usr/local/bin | grep '../Library/Frameworks/Python.framework/Versions/x.x' | awk '{print $9}' | tr -d @ | xargs rm
完成以上三步,即可彻底移除一个 Python 版本。操作时请将 x.x 替换为实际版本号。
虚拟环境搭建详解
Python 项目开发中最令人头疼的问题是什么?——不同项目依赖不同版本的第三方库,全局安装迟早会引发冲突。虚拟环境正是为解决此问题而生:它为每个项目创建独立的运行空间,互不干扰。下面重点介绍两款主流工具:virtualenv 和 virtualenvwrapper。
安装虚拟环境工具 virtualenv
1. 安装模块
sudo pip install virtualenv
2. 创建虚拟环境
建议将虚拟环境统一存放在用户目录下的隐藏文件夹中:
mkdir ~/.virtualenvs # 创建集中管理目录
cd ~/.virtualenvs
virtualenv env # env 是环境名称,可自定义
virtualenv venv --python=python2.7 # 指定 Python 版本
3. 激活环境
source ~/.virtualenvs/env/bin/activate
激活后,终端提示符前面会显示 (env),表示已进入该虚拟环境。
4. 退出环境
deactivate
5. 删除环境
rmvirtualenv 环境名
6. 使用技巧
在 Python 脚本头部指定解释器路径:
#!/path/to/env/bin/python
这样脚本便会自动调用该虚拟环境内的 Python 解释器及其依赖包。
默认情况下,虚拟环境会继承全局 Python 的 site-packages 目录,即全局安装的第三方库在虚拟环境中也可使用。若不希望继承,创建时需添加参数:
virtualenv --system-site-packages ENV
不加该参数时,虚拟环境就是一个干净的空间,仅包含最基础的包。
虚拟环境管理工具 virtualenvwrapper
频繁使用 source 命令激活/退出虚拟环境难免有些繁琐。virtualenvwrapper 提供了更便捷的命令行工具,大幅提升效率。
1. 安装
sudo pip install virtualenvwrapper
默认安装到 /usr/local/bin 目录下。
2. 配置环境变量
打开用户目录下的 .bash_profile 文件:
vim ~/.bash_profile
添加以下配置内容:
# Python 虚拟环境配置
export WORKON_HOME=~/.virtualenvs # 虚拟环境存放路径
source /usr/local/bin/virtualenvwrapper.sh # 激活脚本路径
export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python2.7 # 默认 Python 版本
保存退出后,执行激活命令:
source ~/.bash_profile
3. 常用指令速查
创建新环境:
mkvirtualenv xxx
指定 Python 版本创建:
mkvirtualenv -p /usr/local/bin/python3 [虚拟环境名称]
mkvirtualenv -p /usr/local/bin/python2 [虚拟环境名称]
删除环境:
rmvirtualenv xxx
列出所有环境:
lsvirtualenv -b
启动/切换环境(也可查看所有环境):
workon xxx
退出当前环境:
deactivate
查看帮助信息:
virtualenvwrapper --help
如果在安装或激活过程中遇到失败,尝试卸载后重新安装一次,大部分问题都能得到解决。
Windows 环境下安装虚拟环境
Windows 下的操作与 Mac 大同小异,主要区别在于 pip 包名和路径配置:
pip install virtualenvwrapper-win
设置虚拟环境目录:在系统环境变量中添加 WORKON_HOME = D:.virtualenvs,之后可将该文件夹设置为隐藏属性。
常见报错及解决方案
1. 登录服务器提示:There was a problem running the initialization hooks.
错误信息类似:
./virtualenvwrapper.sh: line 230: : command not found
virtualenvwrapper.sh: There was a problem running the initialization hooks.
If Python could not import the module virtualenvwrapper.hook_loader,
check that virtualenvwrapper has been installed for
VIRTUALENVWRAPPER_PYTHON= and that PATH is
set properly.
根本原因在于 virtualenvwrapper.sh 脚本默认使用 which python 来定位 Python 解释器,但系统可能没有正确配置 Python 路径。解决办法是手动修改该脚本文件:
# 原本是写的which python,这里贴出来的是我修改为python3后的
VIRTUALENVWRAPPER_PYTHON="$(command which python3)"
修改后保存文件,再重新激活配置即可生效。
参考: virtualenvwrapper.sh报错: There was a problem running the initialization hooks.解决
参考:详述 Mac 系统下安装及卸载 Python 的方法 / Pycharm切换python2或3以及删除多于版本 / mac下配置python的虚拟环境virtualenv和虚拟环境管理包virtualenvwrapper / 安装独立Python虚拟环境:virtualenv / Mac 创建指定版本的python虚拟环境 / mac上Homebrew安装以及python安装
