Python3.7安装教程

www.xservx.com · 蜀ICP备2026035467号-3

⚡ Python3.7安装全流程:Windows/macOS/Linux三平台详解

Python3.7作为长期支持版本(LTS),自2018年6月发布以来,因其卓越的性能优化、f-string增强、数据类支持等特性,成为企业级开发与科研计算的首选版本之一。本教程提供权威、完整、可复现的安装步骤,覆盖主流操作系统,确保零基础用户也能顺利部署。

📌 核心优势:Python3.7引入了asyncio性能提升、dataclasses标准库、更精确的__init_subclass__机制,同时保持与Python3.6的代码兼容性,是迁移与新项目部署的理想选择。

Windows平台安装(64位系统推荐)

Windows用户常因路径配置失败导致python命令无法识别,本指南采用“一键安装+手动校验”双保险方案,彻底规避此类问题。

  1. 访问官网:https://www.python.org/downloads/release/python-379/
  2. 下载安装包:Windows x86-64 executable installer(推荐)或Windows x86-64 web-based installer(需联网)
  3. 运行安装程序,关键步骤:
    • 勾选「Add Python 3.7 to PATH」(否则后续需手动配置环境变量)
    • 选择「Customize installation」→「Next」→保留默认勾选项(含pip、py launcher)→「Install」
  4. 校验安装:
    Win+R → 输入cmd → 回车 → 执行:
    py --version
    python --version
    pip --version

若显示Python 3.7.x与pip 19.x,即安装成功。若python命令报错,需手动添加环境变量:

  1. 手动配置环境变量(备用方案):
    • 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
    • 在「系统变量」中找到Path→「编辑」→「新建」→添加:
      C:\Users\用户名\AppData\Local\Programs\Python\Python37\
      C:\Users\用户名\AppData\Local\Programs\Python\Python37\Scripts\
    • 重启终端,重新执行校验命令

macOS平台安装(推荐Homebrew)

macOS系统自带Python2.7,但Python3需单独安装。使用Homebrew可避免权限冲突与路径混乱问题。

⚠️ 注意:macOS 12+系统需先安装Command Line Tools:
xcode-select --install
  1. 安装Homebrew(若未安装):
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  2. 更新Homebrew:
    brew update && brew upgrade
  3. 安装Python3.7:
    brew install python@3.7
    # 若报错,尝试:
    brew install https://raw.githubusercontent.com/Homebrew/homebrew-core/9f3c3f48c/Formula/python@3.7.rb
  4. 创建软链接(确保命令可用):
    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
  5. 校验:
    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是否存在

常见安装陷阱与解决方案

❌ 问题1:Windows提示“此计算机上未安装Microsoft Visual C++ 14.0”

根本原因:Python3.7源码编译需MSVC 14.0+运行时。解决方案:

  • 安装Microsoft Visual C++ Build Tools 2017(轻量版)
  • 或改用预编译的.exe安装包(推荐)
❌ 问题2:macOS安装后pip命令未找到

Homebrew安装的Python3.7默认安装在/usr/local/opt/python@3.7/bin/,需添加PATH:
echo 'export PATH="/usr/local/opt/python@3.7/bin:$PATH"' >> ~/.zshrc后重启终端。

❌ 问题3:Linux中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\

操作步骤:

  1. 打开「系统属性」→「高级」→「环境变量」
  2. 在「系统变量」区域选中Path→「编辑」
  3. 点击「新建」→粘贴路径→确认
  4. 重启所有终端窗口

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”错误

常见于网络受限环境,解决方案:

  1. 临时禁用SSL验证(不推荐生产环境):
    pip3.7 install requests --trusted-host pypi.org --trusted-host files.pythonhosted.org
  2. 更新证书(推荐):
    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)

虚拟环境操作全流程

1. 创建项目目录
mkdir myproject && cd myproject
2. 创建虚拟环境
python3.7 -m venv venv
3. 激活环境
source venv/bin/activate(Linux/macOS)
venv\Scripts\activate(Windows)
4. 安装依赖
pip install flask requests
5. 生成依赖清单
pip freeze > requirements.txt
6. 退出环境
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未安装pip或PATH未包含Scripts目录
🔧 解决:python3.7 -m ensurepip --upgrade

问题2:pip安装时卡在“Collecting package metadata (repodata.json)”

💡 原因:默认PyPI源响应缓慢
🔧 解决:pip install pkg -i https://pypi.tuna.tsinghua.edu.cn/simple

问题3:安装包时出现“Microsoft Visual C++ 14.0 or greater is required”

💡 原因:包需编译C扩展但缺少MSVC
🔧 解决:
• 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'

💡 原因:编译Python时未启用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