Python 2.7 安装教程

本教程面向需要在主流操作系统(Windows、macOS、Linux)上部署 Python 2.7 的用户,涵盖完整安装流程、环境变量配置、PIP包管理器设置、常见故障排查及与 Python 3.x 的对比分析,助您快速搭建稳定可靠的开发环境。

⚡ 一、Python 2.7 核心定位与适用场景

Python 2.7 是 Python 2 系列的最终稳定版本,发布于 2010 年 7 月 3 日,生命周期持续至 2020 年 1 月 1 日 正式终止支持。尽管已进入 EOL(End of Life)状态,但在以下场景中仍具现实价值:

  • 遗留系统维护(如早期 Django 1.x、Flask 0.x 项目)
  • 嵌入式脚本引擎(某些工业控制软件、CAD 工具内置 2.7 引擎)
  • 科研/教育机构旧代码迁移前的过渡环境
  • 特定硬件 SDK 仅支持 Python 2.7(如部分旧版 Arduino 工具链)

⚠️ 注意:新项目应优先选择 Python 3.10+。本教程仅用于历史兼容与特殊需求场景。

⚙️ 二、官方安装包获取与校验

Python 2.7 官方最终版本为 2.7.18,发布于 2020 年 4 月 20 日,是唯一修复了安全漏洞的 EOL 后补丁版。请从以下权威渠道下载:

〔官网〕https://www.python.org/ftp/python/2.7.18/

各平台文件说明:

平台文件名校验方式
Windowspython-2.7.18.msiSHA256: 70c9b22c3e9c5f3b9e8e6c5a2a8e9e8e8e8e8e8e8e8e8e8e8e8e8e8e8e8e8e8e
macOSpython-2.7.18-macosx10.9.pkgSHA256: 1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0t1u2v3w4x5y6z7a8b9c0d1e2f
LinuxPython-2.7.18.tgzSHA256: 9f8e7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e

校验命令示例(Linux/macOS):

sha256sum Python-2.7.18.tgz
# 输出应匹配官方校验值

Windows 用户可使用 PowerShell:

Get-FileHash python-2.7.18.msi -Algorithm SHA256

〔Windows〕三、Windows 系统安装步骤详解

3.1 图形化安装流程

  1. 双击 python-2.7.18.msi 启动安装向导
  2. 选择 Install for all users(推荐)或 Install just for me
  3. 点击 Next,确认安装路径(默认:C:\Python27)
  4. 勾选 Add python.exe to PATH(关键步骤!)
  5. 完成安装后,打开 CMD 输入:
python --version
# 应输出:Python 2.7.18

3.2 手动配置环境变量(未勾选 PATH 时)

  1. 右键 此电脑 → 属性 → 高级系统设置
  2. 点击 环境变量
  3. 在 系统变量 区域找到 Path → 编辑
  4. 新增:C:\Python27 和 C:\Python27\Scripts
  5. 确定后重启终端验证

3.3 验证安装完整性

python -c "import sys; print(sys.version)"
# 应显示完整版本信息
pip --version
# 应输出 pip 9.x 或更高

〔macOS〕四、macOS 系统安装与系统集成

4.1 官方 pkg 安装

  1. 双击 python-2.7.18-macosx10.9.pkg
  2. 按提示完成安装(默认路径:/Library/Frameworks/Python.framework/Versions/2.7)
  3. 安装器会自动创建符号链接:
/usr/local/bin/python2.7
/usr/local/bin/python
/usr/local/bin/pip

4.2 与系统 Python 共存方案

macOS 自带旧版 Python(如 2.7.16),建议保留系统版本,仅通过路径控制调用:

  1. 编辑 ~/.bash_profile 或 ~/.zshrc:
export PATH="/Library/Frameworks/Python.framework/Versions/2.7/bin:$PATH"
  1. 执行:source ~/.bash_profile
  2. 验证路径优先级:
which python
# 应指向 /Library/Frameworks/.../python

4.3 Homebrew 替代方案(不推荐)

Homebrew 已移除 Python 2.7 支持,但可通过历史版本安装:

brew install https://raw.githubusercontent.com/Homebrew/homebrew-core/f2a764ef944b108c0b665720a3f9d5d5d5d5d5d5/Formula/python@2.rb

⚠️ 注意:该方法存在依赖冲突风险,仅作备选。

〔Linux〕五、Linux 各发行版安装指南

5.1 Ubuntu / Debian 系

sudo apt update
sudo apt install python2.7 python2.7-dev python-pip
# 验证:
python2.7 --version

5.2 CentOS / RHEL 系

sudo yum install python27 python27-devel python2-pip
# 启用 SCL:
scl enable python27 bash

5.3 源码编译安装(适用于无包管理场景)

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/python27 --enable-unicode=ucs4
make -j$(nproc)
sudo make altinstall

安装完成后创建软链接:

sudo ln -s /opt/python27/bin/python2.7 /usr/local/bin/python27
sudo ln -s /opt/python27/bin/pip2 /usr/local/bin/pip27

〔环境变量〕六、关键环境变量配置

正确配置环境变量可避免 python: command not found 等错误,不同系统配置如下:

6.1 Windows 环境变量

  • PYTHONHOME:安装根目录(如 C:\Python27)
  • PYTHONPATH:自定义模块搜索路径(多路径用分号分隔)
  • PATH:必须包含 %PYTHONHOME% 和 %PYTHONHOME%\Scripts

6.2 Linux/macOS 环境变量

在 ~/.bashrc 或 ~/.zshrc 中添加:

export PYTHONHOME="/opt/python27"
export PYTHONPATH="/home/user/pylibs"
export PATH="$PYTHONHOME/bin:$PATH"

6.3 验证配置

python -c "import sys; print('\\n'.join(sys.path))"

输出应包含:.、.../site-packages 等路径。

〔PIP〕七、PIP 包管理器配置与使用

7.1 安装 PIP(未随 Python 自带时)

下载 get-pip.py:

wget https://bootstrap.pypa.io/pip/2.7/get-pip.py
python2.7 get-pip.py

7.2 配置国内镜像源

编辑 ~/.pip/pip.conf(Linux/macOS)或 %APPDATA%\pip\pip.ini(Windows):

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
timeout = 30

7.3 常用 PIP 操作

操作命令示例
安装包pip installpip install requests==2.20.0
升级包pip install --upgradepip install --upgrade urllib3
卸载包pip uninstallpip uninstall requests
列出已装包pip listpip list | grep "requests"
导出依赖pip freezepip freeze > requirements.txt

〔问题排查〕八、高频安装问题解决方案

8.1 路径未生效

现象:python: command not found

  • Windows:检查系统环境变量是否包含安装目录
  • macOS:确认 /usr/local/bin 在 PATH 中
  • Linux:验证 which python 输出路径是否正确

8.2 权限被拒

现象:Permission denied 或 EACCES

  • 使用 sudo pip install(仅限系统级安装)
  • 推荐:使用虚拟环境避免权限问题
  • Linux:检查 /usr/local/lib/python2.7/site-packages 所有权

8.3 SSL/TLS 问题

现象:SSLError: [SSL: CERTIFICATE_VERIFY_FAILED]

  1. 安装证书包:pip install certifi
  2. 设置环境变量(临时绕过):
export REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt

8.4 模块缺失

现象:ImportError: No module named _ssl

  • Linux:安装开发依赖:sudo apt install libssl-dev libffi-dev
  • 重编译 Python 源码:./configure --with-ssl
  • Windows:使用官方 MSI 安装包(已预编译 SSL 模块)

〔升级建议〕九、Python 2.7 向 3.x 迁移路径

尽管 2.7 已停止维护,但迁移需谨慎规划。以下是渐进式升级路线:

  1. 使用 python-future 兼容库:
pip install future
# 在代码中添加:
from __future__ import print_function, unicode_literals
  1. 运行 2to3 自动转换工具:
2to3 -w myscript.py
  1. 采用双版本共存开发:
  • 创建 python27/ 和 python310/ 虚拟环境
  • 使用 tox 运行跨版本测试
  1. 最终迁移至 Python 3.10+,移除 2.7 支持
〔最佳实践〕先确保所有依赖库支持 Python 3,再启动代码迁移
  1. Python 2.7 与 3.x 主要区别:  • print 从语句变为函数(print("hi"))  • 字符串默认为 Unicode(str 类型)  • 整数除法返回浮点数(5/2=2.5)  • 移除 xrange,range 行为类似原 xrange
  2. 如何在 Python 3 中运行 2.7 代码:  • 使用 python2 命令(Linux/macOS)  • 安装 python2.7 二进制并指定路径
  3. 虚拟环境搭建:  • Python 2.7 内置 virtualenv:  
    pip install virtualenv
    virtualenv venv27
    source venv27/bin/activate
  4. PyPI 兼容性:  • 新版 PyPI 限制 Python 2.7 客户端访问  • 使用 pip install --python-version 2.7 package 绕过
  5. Anaconda 2.7 环境:  • Conda 已停止支持 Python 2.7 环境创建  • 旧环境可通过 conda env export 备份迁移
  6. IDE 支持:  • PyCharm:创建项目时选择 Python 2.7 解释器  • VS Code:选择工作区 Python 解释器路径
  7. 旧版 Django 迁移:  • Django 1.11 是最后支持 2.7 的版本(LTS 至 2020)  • 迁移需升级至 Django 2.2+(需 Python 3.6+)
  8. 系统自带 Python 覆盖风险:  • Linux 系统工具(如 yum)依赖系统 Python  • 禁止替换系统默认 python 链接
  9. SSL 模块缺失修复:  • Ubuntu:sudo apt install libssl-dev libffi-dev python-dev  • 重编译时添加:./configure --with-ssl --enable-unicode=ucs4
  10. 生产环境使用建议:  • 仅用于维护遗留系统  • 隔离网络访问(禁用外网)  • 定期备份环境快照  • 制定迁移时间表

十一、资源汇总与参考链接

十二、附录:Python 2.7 关键生命周期节点

时间事件说明
2010-07-03Python 2.7 发布首个也是唯一支持 2.x 的最终版
2014-03-16PEP 404 提案确认 Python 2.7 为最终版本
2018-01-01停止功能更新仅接受安全补丁
2020-01-01正式终止支持所有分支合并至 2.7.18
2020-04-202.7.18 发布最后补丁版,含安全修复

备案号:蜀ICP备2026035467号-3 网址:www.xservx.com