Python27安装|全平台部署权威指南
Python 2.7作为Python语言历史中承前启后的重要版本,自2010年7月3日发布以来,已为无数开发者、科研工作者及企业系统提供了稳定可靠的运行环境。尽管Python 2.7已于2020年1月1日进入生命周期终结(EOL)状态,但因历史遗留系统、特定库依赖、嵌入式设备固件等现实约束,其在部分生产环境、教育场景及安全研究领域仍具不可替代价值。
本指南面向需要部署Python 2.7环境的技术人员,提供详尽、可复现的安装方案,涵盖Windows、macOS、Linux三大主流平台,每一步均经实际环境验证。内容不仅包含基础安装流程,更深入解析环境变量配置陷阱、路径冲突处理、多版本共存策略、虚拟环境隔离技巧,以及与Python 3生态的兼容性应对方案。所有内容均以实战经验为基础,拒绝空泛描述,力求读者“照做即能用”。
需特别说明:Python 2.7已不再接收安全更新,**强烈建议新项目直接采用Python 3.10+**。仅当面对遗留系统迁移、特定工具链(如旧版Ansible、SaltStack)、嵌入式设备SDK或合规性要求等场景时,才应部署Python 2.7。部署前请务必评估风险,制定过渡计划。
📌 本指南覆盖范围
- Windows平台(Win7~Win11):通过官方安装包、Chocolatey、Scoop、源码编译四种方式
- macOS平台(10.15~14):通过Homebrew、官方pkg、pyenv、源码编译
- Linux平台(Ubuntu 18.04/20.04/22.04、CentOS 7/8、Debian 10/11):包管理器安装、源码编译、pyenv管理
- 环境变量深度配置:PATH、PYTHONPATH、PYTHONHOME、PYTHONIOENCODING
- 虚拟环境:virtualenv、venv(需兼容模块)、conda(Python 2.7环境)
- 常见问题排查:权限错误、路径冲突、SSL/TLS缺失、pip缺失、C扩展编译失败
- Python 2→3迁移准备:2to3工具使用、兼容性检查清单
一、全平台安装方案详解
1.1 Windows平台安装(Win7~Win11)
Windows系统默认不预装Python,需手动安装。Python 2.7官方最后版本为2.7.18,发布于2020年4月12日,是唯一官方支持的最终版本。安装方式有四种:
方式①:官方安装包(推荐新手)
- 访问Python 2.7.18官方安装包(64位)或64位版本(32位用户请选择第一个链接)
- 右键以管理员身份运行,勾选【Add Python 2.7 to PATH】(关键!)
- 安装类型选择【Customize installation】→ 下一步 → 勾选【Install for all users】→ 下一步
- 确认安装路径(推荐:C:\Python27),点击【Install】
- 完成后打开CMD,输入:
python --version,应输出:Python 2.7.18
控制面板→系统→高级系统设置→环境变量→系统变量→Path→末尾追加:
;C:\Python27;C:\Python27\Scripts方式②:Chocolatey包管理器(适合开发者)
- 以管理员身份运行PowerShell,执行:
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1')) - 安装Python 2.7:
choco install python2 -y - 验证:
python --version→ 应显示Python 2.7.18
py -0p查看版本列表,或使用py -2显式调用Python 2方式③:Scoop包管理器(轻量级)
- 以普通用户身份运行PowerShell:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 安装Scoop:
iwr -useb get.scoop.sh | iex - 添加 extras bucket:
scoop bucket add extras - 安装Python 2.7:
scoop install python27 - 验证:
python --version
~\scoop\apps\python27\current\,自动加入PATH方式④:源码编译(高级用户)
适用于需要定制模块或旧系统(如Win7 SP1无MSVC支持):
- 下载Python 2.7.18源码:
https://www.python.org/ftp/python/2.7.18/Python-2.7.18.tgz - 解压后进入目录,运行:
configure --prefix=C:\Python27(需MSYS2或Cygwin环境) - 执行:
make && make install - 手动配置环境变量(同官方安装包步骤)
1.2 macOS平台安装(10.15~14)
macOS自带Python 2.7(如10.15为2.7.16),但版本较旧且路径受System Integrity Protection(SIP)保护,**禁止直接覆盖**。推荐以下方案:
方式①:Homebrew(首选)
- 安装Homebrew(若未安装):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 安装Python 2.7:
brew install python@2.7
(注:Homebrew 4.0+已移除python@2.7,需使用第三方tap) - 添加第三方tap:
brew tap pyenv/pyenv
或使用:brew install python@2.7(需确认仓库状态) - 若上述失败,改用pyenv方案
python2.7 --version 或 /usr/local/opt/python@2.7/bin/python2.7 --version方式②:官方pkg安装包
- 下载:python-2.7.18-macosx10.9.pkg
- 双击运行安装包,安装至:
/Library/Frameworks/Python.framework/Versions/2.7 - 安装后自动创建软链接:
/usr/local/bin/python2.7、/usr/local/bin/pip2.7 - 验证:
python2.7 --version
/usr/local/bin置于PATH最前:echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bash_profile方式③:pyenv(多版本管理)
- 安装pyenv:
brew install pyenv - 配置shell(bash/zsh):
echo 'eval "$(pyenv init -)"' >> ~/.bash_profile - 安装Python 2.7.18:
pyenv install 2.7.18 - 设为全局版本:
pyenv global 2.7.18 - 验证:
python --version→Python 2.7.18
1.3 Linux平台安装(Ubuntu/CentOS/Debian)
多数Linux发行版已预装Python 2.7,但版本可能较低(如Ubuntu 20.04为2.7.17)。安装前请检查:python --version 或 python2 --version
方式①:apt包管理器(Ubuntu/Debian)
- 更新索引:
sudo apt update - 安装Python 2.7及pip:
sudo apt install python2.7 python2.7-dev python-pip - 创建python2软链接(可选):
sudo ln -s /usr/bin/python2.7 /usr/local/bin/python2 - 验证:
python2 --version
sudo apt install software-properties-commonsudo add-apt-repository ppa:deadsnakes/ppasudo apt updatesudo apt install python2.7方式②:yum/dnf包管理器(CentOS/RHEL)
- CentOS 7默认含Python 2.7.5,无需安装
- CentOS 8/RHEL 8需启用PowerTools仓库:
sudo dnf config-manager --set-enabled powertools - 安装:
sudo dnf install python2 python2-pip - 创建软链接:
sudo ln -s /usr/bin/python2 /usr/local/bin/python2
方式③:源码编译(定制需求)
- 安装编译依赖:
sudo apt install build-essential libssl-dev zlib1g-dev libncurses5-dev libncursesw5-dev libreadline-dev libsqlite3-dev libgdbm-dev liblzma-dev libbz2-dev - 下载源码:
wget https://www.python.org/ftp/python/2.7.18/Python-2.7.18.tgz - 解压并编译:
tar xzf Python-2.7.18.tgz && cd Python-2.7.18./configure --prefix=/opt/python2.7 --enable-ipv6 --enable-unicode=ucs4make -j$(nproc) && sudo make install - 添加PATH:
echo 'export PATH="/opt/python2.7/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc - 验证:
python2.7 --version
--enable-unicode=ucs4可避免某些库(如MySQLdb)的Unicode错误二、环境变量深度配置
正确配置环境变量是确保Python 2.7稳定运行的关键,尤其在多版本共存时。核心变量包括:
- PATH:系统查找可执行文件的路径,需包含Python安装目录及Scripts子目录
- PYTHONPATH:Python模块搜索路径,用于扩展标准库查找范围
- PYTHONHOME:指定Python安装根目录(通常自动设置,慎用)
- PYTHONIOENCODING:设置标准输入/输出编码(如UTF-8),避免中文乱码
环境变量配置示例
Windows(系统变量):
PATH = ... ;C:\Python27;C:\Python27\Scripts
PYTHONPATH = D:\MyLibs;C:\Projects\Utils
PYTHONIOENCODING = utf-8
Linux/macOS(~/.bashrc 或 ~/.zshrc):
export PATH="/usr/local/opt/python@2.7/bin:/opt/python2.7/bin:$PATH"
export PYTHONPATH="/home/user/mylibs:$PYTHONPATH"
export PYTHONIOENCODING="utf-8"
export PYTHONHOME="/opt/python2.7"(仅源码编译需)
2.1 Windows环境变量设置步骤
- 右键【此电脑】→【属性】→【高级系统设置】
- 点击【环境变量】
- 在【系统变量】区域找到【Path】→【编辑】
- 点击【新建】,添加:
C:\Python27
C:\Python27\Scripts - 点击【新建】添加PYTHONPATH:
PYTHONPATH = D:\MyLibs;C:\Projects\Utils - 点击【新建】添加PYTHONIOENCODING:
PYTHONIOENCODING = utf-8 - 重启终端生效
2.2 Linux/macOS环境变量设置
- 编辑shell配置文件:
nano ~/.bashrc(bash)或nano ~/.zshrc(zsh) - 追加以下内容:
export PATH="/usr/local/opt/python@2.7/bin:$PATH"
export PYTHONPATH="/home/user/mylibs:$PYTHONPATH"
export PYTHONIOENCODING="utf-8" - 应用配置:
source ~/.bashrc
创建
test.py:import sys; print(sys.path)运行:
python test.py → 应包含/home/user/mylibs三、虚拟环境搭建与管理
虚拟环境可隔离不同项目的依赖,避免版本冲突。Python 2.7推荐使用virtualenv(venv需额外安装模块)。
3.1 virtualenv安装与使用
- 安装virtualenv(需pip):
pip install virtualenv - 创建虚拟环境:
virtualenv -p python2.7 venv27 - 激活环境:
- Windows:venv27\Scripts\activate
- Linux/macOS:source venv27/bin/activate - 退出环境:
deactivate
virtualenv高级选项
-p:指定Python解释器路径--no-site-packages:隔离系统包(默认行为)--relocatable:使环境可移动(慎用)
3.2 venv兼容方案(Python 2.7)
Python 2.7标准库的venv模块需手动安装:
- 安装backport模块:
pip install virtualenv-clone - 使用:
python -m venv venv27(需先安装virtualenv包)
3.3 conda环境(Anaconda用户)
- 安装Anaconda/Miniconda(支持Python 2.7的版本,如Miniconda2)
- 创建环境:
conda create -n py27 python=2.7 - 激活:
conda activate py27
四、兼容性与关键问题排查
4.1 Python 2与Python 3核心差异
| 特性 | Python 2 | Python 3 |
|---|---|---|
| print语句 | print "Hello" | print("Hello") |
| 除法运算 | 5/2 = 2(整除) | 5/2 = 2.5(真除) |
| Unicode支持 | str为字节串,unicode为文本 | str为文本,bytes为字节串 |
| xrange | 存在 | 移除,range行为等同xrange |
| input() | 读取表达式 | 读取字符串(等同raw_input) |
4.2 常见错误及解决方案
错误:SSL模块缺失(ImportError: No module named _ssl)
原因:编译时未启用SSL支持,或系统缺少openssl开发库
解决方案:
- Ubuntu/Debian:
sudo apt install libssl-dev
重新编译Python 2.7 - macOS:
brew install openssl
./configure --with-openssl=/usr/local/opt/openssl - Windows:
安装时勾选【Install SSL certificates】
错误:pip未安装('pip' is not recognized)
原因:Python 2.7.9+才内置pip,旧版本需手动安装
解决方案:
- 下载get-pip.py:
curl https://bootstrap.pypa.io/pip/2.7/get-pip.py -o get-pip.py - 运行:
python2.7 get-pip.py
- Windows:
C:\Python27\Scripts\pip.exe- Linux/macOS:
/usr/local/bin/pip2.7错误:UnicodeDecodeError / UnicodeEncodeError
原因:默认编码为ASCII,处理中文等非ASCII字符时失败
解决方案:
- 设置环境变量:
export PYTHONIOENCODING=utf-8 - 在代码开头添加:
# -*- coding: utf-8 -*-
import sys; reload(sys); sys.setdefaultencoding('utf-8') - 使用
u"中文"显式声明Unicode字符串
错误:C扩展编译失败(error: command 'gcc' failed with exit status 1)
原因:缺少开发头文件(如python2.7-dev)
解决方案:
- Ubuntu/Debian:
sudo apt install python2.7-dev build-essential - CentOS/RHEL:
sudo yum install python-devel gcc - macOS:
sudo xcode-select --install
4.3 SSL/TLS证书验证问题
Python 2.7.9+支持SSL,但证书验证可能失败(如旧版OpenSSL)。解决方案:
- 安装certifi包:
pip install certifi - 在代码中使用:
import certifi; ssl.create_default_context(cafile=certifi.where()) - 或临时禁用验证(仅测试环境):
urllib2.urlopen(url, context=ssl._create_unverified_context())
五、Python 2→3迁移准备
5.1 2to3工具使用
Python提供2to3工具自动转换代码:
- 安装(通常已包含):
sudo apt install python3 - 转换单文件:
2to3 -w myscript.py - 转换整个目录:
2to3 -w -n myproject/
2to3自动转换示例
5.2 兼容性检查清单
- 所有
print语句改为函数调用 - 除法运算:明确使用
/(真除)或//(整除) - 字典方法:
.iteritems()→.items() - 输入函数:
raw_input()→input() - 异常语法:
except Exception, e→except Exception as e - 模块重命名:
urllib2→urllib.request
5.3 依赖库迁移策略
常见Python 2特有库替代方案
| Python 2库 | Python 3替代 | 备注 |
|---|---|---|
| urllib2 | urllib.request | API结构变化较大 |
| ConfigParser | configparser | 模块名小写 |
| cPickle | pickle | Python 3中cPickle已合并 |
| Queue | queue | 模块名小写 |
| StringIO | io.StringIO | 需导入io模块 |
六、高频问题解答(FAQ)
Q1:Python 2.7与Python 3能否共存?
可以! 安装时指定不同路径即可。建议:
- Windows:使用
py -2和py -3调用不同版本 - Linux/macOS:保持
python2和python3命令区分
Q2:如何彻底卸载Python 2.7?
Windows:
控制面板→卸载程序→找到【Python 2.7】→卸载
手动删除:C:\Python27及%APPDATA%\Python
Linux/macOS:
- apt/yum安装:sudo apt remove python2.7
- 源码编译:sudo rm -rf /opt/python2.7
- 删除软链接:sudo rm /usr/local/bin/python2.7
Q3:pip安装包失败(HTTPS/SSL错误)
原因:旧版pip不支持TLS 1.2+
解决方案:
- 升级pip:
python2.7 -m pip install --upgrade pip - 若失败,使用
easy_install:
easy_install -U pip - 最后手段:下载wheel文件手动安装
Q4:如何查看已安装的Python 2.7包?
- 列出所有包:
pip list或pip freeze - 查看特定包信息:
pip show requests - 检查包路径:
python -c "import requests; print(requests.__file__)"
Q5:Python 2.7还能用于新项目吗?
不推荐! 但以下场景例外:
- 嵌入式设备(如树莓派旧固件)
- 特定安全研究工具(如旧版Metasploit模块)
- 遗留系统过渡期(需制定2025年前迁移计划)