⚡ Python3.7安装全流程:Windows/macOS/Linux三平台详解
Python3.7作为长期支持版本(LTS),自2018年6月发布以来,因其卓越的性能优化、f-string增强、数据类支持等特性,成为企业级开发与科研计算的首选版本之一。本教程提供权威、完整、可复现的安装步骤,覆盖主流操作系统,确保零基础用户也能顺利部署。
📌 核心优势:Python3.7引入了asyncio性能提升、dataclasses标准库、更精确的__init_subclass__机制,同时保持与Python3.6的代码兼容性,是迁移与新项目部署的理想选择。
Windows平台安装(64位系统推荐)
Windows用户常因路径配置失败导致python命令无法识别,本指南采用“一键安装+手动校验”双保险方案,彻底规避此类问题。
- 访问官网:https://www.python.org/downloads/release/python-379/
- 下载安装包:Windows x86-64 executable installer(推荐)或
Windows x86-64 web-based installer(需联网) - 运行安装程序,关键步骤:
- 勾选「Add Python 3.7 to PATH」(否则后续需手动配置环境变量)
- 选择「Customize installation」→「Next」→保留默认勾选项(含
pip、py launcher)→「Install」
- 校验安装:
Win+R → 输入cmd → 回车 → 执行: py --version python --version pip --version
若显示Python 3.7.x与pip 19.x,即安装成功。若python命令报错,需手动添加环境变量:
- 手动配置环境变量(备用方案):
- 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
- 在「系统变量」中找到
Path→「编辑」→「新建」→添加:
C:\Users\用户名\AppData\Local\Programs\Python\Python37\
C:\Users\用户名\AppData\Local\Programs\Python\Python37\Scripts\ - 重启终端,重新执行校验命令
macOS平台安装(推荐Homebrew)
macOS系统自带Python2.7,但Python3需单独安装。使用Homebrew可避免权限冲突与路径混乱问题。
xcode-select --install
- 安装Homebrew(若未安装):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- 更新Homebrew:
brew update && brew upgrade - 安装Python3.7:
brew install python@3.7 # 若报错,尝试: brew install https://raw.githubusercontent.com/Homebrew/homebrew-core/9f3c3f48c/Formula/python@3.7.rb
- 创建软链接(确保命令可用):
echo 'export PATH="/usr/local/opt/python@3.7/bin:$PATH"' >> ~/.zshrc source ~/.zshrc ln -s /usr/local/opt/python@3.7/bin/python3.7 /usr/local/bin/python3.7 ln -s /usr/local/opt/python@3.7/bin/pip3.7 /usr/local/bin/pip3.7
- 校验:
python3.7 --version→ 应输出Python 3.7.9
Linux平台(Ubuntu/Debian/CentOS通用)
Linux发行版通常提供Python3.7,但需注意源兼容性。Ubuntu 18.04+可直接安装,CentOS 7需启用SCL源。
Ubuntu/Debian
sudo apt update sudo apt install software-properties-common sudo add-apt-repository ppa:deadsnakes/ppa sudo apt update sudo apt install python3.7 python3.7-venv python3.7-dev
CentOS 7(需启用EPEL+SCL)
sudo yum install epel-release sudo yum install rh-python37 # 启用环境: scl enable rh-python37 bash
通用校验
python3.7 -m ensurepip --upgrade python3.7 -m pip install --upgrade pip
安装后验证清单
✅ 基础验证
python3.7 --version → Python 3.7.9
pip3.7 --version → pip 19.2.3+
✅ 标准库测试
python3.7 -c "import dataclasses; print('✓ dataclasses OK')"
python3.7 -c "import asyncio; print('✓ asyncio OK')"
✅ pip功能验证
pip3.7 install requests --user
检查~/.local/lib/python3.7/site-packages/requests是否存在
常见安装陷阱与解决方案
根本原因:Python3.7源码编译需MSVC 14.0+运行时。解决方案:
- 安装
Microsoft Visual C++ Build Tools 2017(轻量版) - 或改用预编译的
.exe安装包(推荐)
Homebrew安装的Python3.7默认安装在/usr/local/opt/python@3.7/bin/,需添加PATH:
echo 'export PATH="/usr/local/opt/python@3.7/bin:$PATH"' >> ~/.zshrc后重启终端。
ModuleNotFoundError: No module named '_ctypes'缺失libffi-dev库:
sudo apt install libffi-dev(Ubuntu)
sudo yum install libffi-devel(CentOS)
⚙️ Python3.7环境变量配置详解
环境变量配置直接影响python、pip命令的可用性。以下提供三种主流场景的完整配置方案。
Windows:系统级与用户级配置
假设安装路径为C:\Python37,需添加以下两项至系统环境变量:
系统变量 Path += 1. C:\Python37\ 2. C:\Python37\Scripts\
操作步骤:
- 打开「系统属性」→「高级」→「环境变量」
- 在「系统变量」区域选中
Path→「编辑」 - 点击「新建」→粘贴路径→确认
- 重启所有终端窗口
macOS/Linux:Shell配置文件修改
根据默认Shell选择配置文件:
Bash用户
编辑~/.bashrc:
echo 'export PATH="/usr/local/opt/python@3.7/bin:$PATH"' >> ~/.bashrc
Zsh用户
编辑~/.zshrc:
echo 'export PATH="/usr/local/opt/python@3.7/bin:$PATH"' >> ~/.zshrc
执行source ~/.bashrc或source ~/.zshrc生效
验证环境变量是否生效
# 终端执行: which python3.7 # 应输出:/usr/local/bin/python3.7 或类似路径 where python3.7 # Windows输出完整路径
环境变量冲突排查
python命令可能指向Python2.7。解决方案:• Windows:使用
py -3.7指定版本• macOS/Linux:使用
python3.7全路径或创建别名:alias py37='python3.7'
配置Python启动器(Windows专属)
Python3.7安装时会自动注册py启动器,支持多版本管理:
py --list # 输出: # Python 3.7 (64-bit) # Python 3.9 (64-bit) py -3.7 script.py # 显式调用3.7版本
📦 pip工具深度配置与优化
pip是Python3.7的官方包管理工具,版本19.0+引入了PEP 517/518构建系统支持,显著提升复杂包的安装成功率。
pip版本检查与升级
pip3.7 --version # 升级: python3.7 -m pip install --upgrade pip
配置pip国内镜像源(永久生效)
默认PyPI源访问缓慢,推荐配置清华源:
临时使用(单次命令)
pip3.7 install requests -i https://pypi.tuna.tsinghua.edu.cn/simple
全局配置(推荐)
创建配置文件:
• Windows:%APPDATA%\pip\pip.ini
• macOS/Linux:~/.pip/pip.conf
[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple [install] trusted-host = pypi.tuna.tsinghua.edu.cn
pip常用命令速查表
| 命令 | 功能 | 示例 |
|---|---|---|
pip3.7 install pkg | 安装包 | pip3.7 install numpy |
pip3.7 uninstall pkg | 卸载包 | pip3.7 uninstall numpy |
pip3.7 list | 列出已安装包 | pip3.7 list | findstr numpy |
pip3.7 show pkg | 查看包详情 | pip3.7 show requests |
pip3.7 freeze | 导出依赖列表 | pip3.7 freeze > requirements.txt |
解决安装时“SSL: CERTIFICATE_VERIFY_FAILED”错误
常见于网络受限环境,解决方案:
- 临时禁用SSL验证(不推荐生产环境):
pip3.7 install requests --trusted-host pypi.org --trusted-host files.pythonhosted.org - 更新证书(推荐):
python3.7 -m pip install --upgrade certifi
VIRTUAL_ENV:虚拟环境搭建与管理
虚拟环境可隔离项目依赖,避免版本冲突。Python3.7原生支持venv模块,无需额外安装。
创建虚拟环境
# 创建: python3.7 -m venv myenv # 激活: # Windows: myenv\Scripts\activate # macOS/Linux: source myenv/bin/activate
激活后终端提示符前会显示(myenv)
虚拟环境操作全流程
mkdir myproject && cd myproject
python3.7 -m venv venv
source venv/bin/activate(Linux/macOS)venv\Scripts\activate(Windows)
pip install flask requests
pip freeze > requirements.txt
deactivate
虚拟环境与系统环境差异对比
系统环境
• 全局安装
• 所有项目共享
• 容易版本冲突
虚拟环境
• 项目隔离
• 独立site-packages
• 可自由切换版本
使用pyenv管理多版本(macOS/Linux进阶)
当需同时使用Python3.6/3.7/3.8时,推荐pyenv:
# 安装pyenv: curl https://pyenv.run | bash # 添加到shell配置: echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc echo 'eval "$(pyenv init -)"' >> ~/.zshrc # 重启终端后: pyenv install 3.7.9 pyenv global 3.7.9 pyenv versions
🔍 Python3.7常见报错解决方案
整理高频报错场景,提供精准修复方案。
问题1:ModuleNotFoundError: No module named 'pip'
🔧 解决:
python3.7 -m ensurepip --upgrade
问题2:pip安装时卡在“Collecting package metadata (repodata.json)”
🔧 解决:
pip install pkg -i https://pypi.tuna.tsinghua.edu.cn/simple
问题3:安装包时出现“Microsoft Visual C++ 14.0 or greater is required”
🔧 解决:
• Windows:安装
Microsoft C++ Build Tools• 或改用预编译wheel:
pip install cp37-win_amd64.whl
问题4:macOS中ImportError: dlopen(...) failed with error: dlopen(...): image not found
🔧 解决:
export DYLD_LIBRARY_PATH="/usr/local/opt/python@3.7/lib:$DYLD_LIBRARY_PATH"echo 'export DYLD_LIBRARY_PATH=...' >> ~/.zshrc
问题5:Linux中ModuleNotFoundError: No module named '_ssl'
🔧 解决:
sudo apt install libssl-dev libffi-dev重新安装Python3.7(使用
./configure --with-ssl)
报错定位工具:sys.path检查
python3.7 -c "import sys; print('\n'.join(sys.path))"输出应包含:/usr/local/lib/python3.7/site-packages