Python 3.10 安装失败主因是 OpenSSL 版本过低(需 ≥1.1.1)或缺失 openssl-devel/libffi-devel,导致 _ssl、_ctypes 等模块编译跳过;Windows 需勾选“Add to PATH”并禁用路径长度限制,推荐使用 Miniconda+pyenv 替代手动编译,并通过 import ssl 和 sqlite3 验证模块是否真正可用。

Python 3.10 安装失败,大概率是 OpenSSL 或 _ssl 模块缺失
CentOS/RHEL 系统上直接编译 Python 3.10,import ssl 报错或 ModuleNotFoundError: No module named '_ssl' 是最常见现象。根本原因不是 Python 本身问题,而是系统自带 OpenSSL 版本太低(CentOS 7 默认是 1.0.2k),而 Python 3.10 要求 OpenSSL ≥ 1.1.1。
- 先检查:
openssl version,低于OpenSSL 1.1.1就必须升级或指定自定义路径 - 不升级 OpenSSL 的话,得在
./configure里显式加--with-openssl=/usr/local/openssl(前提是已源码安装新版 OpenSSL) - 漏装
openssl-devel或libffi-devel也会导致_ctypes、_ssl编译跳过——它们不会报错中断,但后续运行时才暴露
Windows 上装 Python 3.10,PATH 和路径长度限制比版本选择更关键
下载官网 Windows installer (64-bit) 没问题,但安装时两个勾选项决定你之后会不会反复重装:
- 务必勾选
Add python.exe to PATH,否则python --version直接报“不是内部或外部命令” - 安装完弹出的窗口里点
Disable path length limit,不然某些包(比如pytorch或带深层嵌套的 wheel)解压会失败,报错类似OSError: [WinError 206] 文件名或扩展名太长 - 别用默认 C:\Program Files\Python310 —— 中文路径、空格、权限都会引发 pip 安装失败,推荐
D:\Python310这类纯英文无空格路径
想省事又不想被系统 Python 拖累?Miniconda + pyenv 是更稳的选择
手动编译容易卡在依赖、软链接、环境变量冲突;直接覆盖系统 python3 又可能让 yum 或 dnf 崩溃。这时候跳过源码编译,用预编译方案更实际:
-
Miniconda3-latest-Linux-x86_64.sh(或 Windows 对应安装包)自带 Python 3.10,不用装zlib-devel、sqlite-devel等一堆头文件 - 配合
pyenv可随时切换项目级 Python 版本:cd myproject && pyenv local 3.10.12,连pip都自动隔离 - 注意:pyenv 的
shims机制依赖~/.pyenv/shims在$PATH最前面,否则which python还是看到系统默认版本
验证是否真装好了,别只看 python --version
版本号对了不代表能用。很多环境看似安装成功,一跑项目就报 ImportError: cannot import name 'xxx' from 'typing' 或 HTTPS 请求失败——说明 SSL、typing、sqlite 等关键模块没链上。
立即学习“Python免费学习笔记(深入)”;
- 必须执行:
/usr/local/python3.10/bin/python3.10 -c "import ssl; print(ssl.OPENSSL_VERSION)"(Linux)或python -c "import ssl; print(ssl.OPENSSL_VERSION)"(Windows) - 再试一个带 I/O 的:
python -c "import sqlite3; print(sqlite3.sqlite_version)",避免 SQLite 被静默跳过 - 如果用 pip,跑
pip list前先python -m ensurepip,有些最小化安装不带 pip
真正麻烦的从来不是下载和点击安装,而是确认每个底层模块都按预期加载。尤其是 _ssl 和 _sqlite3,它们不报编译错误,只在 runtime 暴雷。










