后台经常有人问我Linux 下怎么装 Python我一般会先反问一句你愿意花二十分钟编译一个只属于你自己的 Python 吗如果你在 CentOS 7 上试过装 Python 3.10或者在 Ubuntu 上被系统自带的 3.8 卡过语法特性你就明白我为什么一直推荐编译安装。这篇 Linux 下 Python 编译安装指南不是搬运官方 README而是把我从依赖清单、configure 参数、到各种报错排查的完整实战过程写出来照着操作基本能一次过。适用的人比你想的广服务器上跑量化回测要装 numpy、pandas 的写爬虫要装 opencv-python 的做嵌入式 Linux 交叉编译环境要维护工具链脚本的还有只想在开发机上用上最新语法特性又不想动系统 Python 的都可以直接参考。全文基于 Python 3.10 版本但安装思路对 3.11、3.12、3.13 同样适用。1. 为什么我坚持用编译安装而不是包管理器或 Anaconda先说实话不是所有场景都要编译安装。如果你只是写写脚本、用系统自带版本完全够用那没必要折腾。但如果你碰到下面任何一种情况包管理器就会显得很无力。第一种情况发行版源里的 Python 版本太老。CentOS 7 的默认源里还躺着 Python 2.7虽然能额外装 python3但版本也停在 3.6 左右。Ubuntu 20.04 默认 3.822.04 默认 3.10。你想精确用 3.10 的时候Ubuntu 22.04 刚好有这个版本但 CentOS / Rocky 用户想都不用想。有人会去加第三方软件源比如 IUS 或 SCL但第三方源的 Python 大多和系统组件深度绑定升级时可能会动 libexpat、libssl 这类核心库把 dnf / apt 本身搞出问题的情况我见过不止一次。第二种情况Anaconda 太重了。Anaconda 确实开箱即用conda 也能管理环境但它默认带你几 GB 用不到的科学计算包而且它的 Python 是独立体系的和系统其它工具链的配合经常出现 Python 解释器路径不一致的隐性问题。团队协作时conda 环境的依赖锁定和 pip 的 requirements.txt 混着用很容易出现我这能跑你那就报错的尴尬。对于跑量化、写脚本、部署服务这些场景一个放在 /usr/local 下的干净 Python 其实更省心。编译安装的核心优势在我看来有三点版本可控。你自己指定装哪个 patch 版本不用等发行版维护者同步。目录独立。装到 /usr/local/python3.10 这种隔离目录和系统其它组件互不干扰。出问题直接删目录重来不用重装系统。性能优化可选。编译时可以开 PGO/LTO 优化跑长计算任务时比发行版默认编译的 Python 有一定优势。后面我会细讲 --enable-optimizations 这个参数。我当年就是被 CentOS 7 的 Python 2.7 烦透了才下定决心自己编译。编译过一次之后后续新机器、新服务器我都用这套流程基本没再被版本问题卡过。2. 编译前的四类前置依赖缺任何一个都会让你半路翻车编译失败最烦的不是 configure 阶段报错而是 make 到一半才报错。因为 configure 会做一些兼容性降级处理有些模块明明缺依赖也能继续编译但等编译完你才发现import ssl失败、pip install用不了那时候再回头找问题比一开始就装齐依赖要痛苦得多。下面按发行版给出两类系统的依赖清单。CentOS / Rocky / 其它 RHEL 系用yumUbuntu / Debian 系用apt。用途CentOS / RockyUbuntu / Debian编译器与构建工具gcc gcc-c makebuild-essential压缩库zlib-devel bzip2 bzip2-devel xz xz-develzlib1g-dev libbz2-dev liblzma-dev网络与加密openssl-devellibssl-devC 扩展与数据库libffi-devel sqlite-devel readline-devel ncurses-devellibffi-dev libsqlite3-dev libreadline-dev libncurses-dev图形/终端可选tk-develtk-dev2.1 编译器与构建工具链没有 gcc 一切免谈Python 源码里绝大部分是 C 代码编译过程本质上是调用 gcc 把解释器源码翻译成机器码。所以工具链没装好后面每一步都会莫名其妙地失败。CentOS 系直接sudo yum install -y gcc gcc-c makeUbuntu 系更简单一个build-essential就把 gcc、g、make 全带上了sudo apt install -y build-essential装完建议随手验证一下gcc --version make --version我遇到过有人用sudo apt install gcc却漏了 g结果 configure 能过make 一编译 C 扩展就报错。所以这一条别省。2.2 压缩库zlib 决定了你的模块能不能解压Python 的zipimport机制靠 zlib 解压内置模块和第三方 wheel 包tar.gz的源码包也是通过它解开的。如果系统里没有 zlib 开发头文件编译过程会出现一个非常坑爹的报错zipimport.ZipImportError: cant decompress data这个错误出现在解释器本身都无法用 zipimport 加载模块的时候属于自己把自己卡死的类型。解决办法只有一个装好 zlib 开发包然后重新编译。注意一定是带-devel或-dev的开发包只装zlib运行时库是没有头文件的Python 找不到zlib.h照样不认。Ubuntu 用户有个容易漏的包liblzma-dev。很多 Linux 发行版默认没有安装 xz 的开发头文件导致 Python 编译出来的lzma模块不可用。pandas读.xz格式的数据文件时就会报错。2.3 网络与加密openssl-devel 直接影响 ssl 模块Python 的ssl、hashlib、http.client都依赖 OpenSSL 库。如果编译时没找到 OpenSSL 头文件Python 会默默地把相关模块标记为不可用编译照样能成功但等你要用 pip 安装包时才发现pip is configured with locations that require TLS/SSL这算是我见过最多的编译成功但实际是半成品的情况。检查方法很简单/usr/local/python3.10/bin/python3.10 -c import ssl; print(ssl.OPENSSL_VERSION)如果报ModuleNotFoundError: No module named ssl就是 OpenSSL 开发包缺失或路径不对。CentOS 7 还有一个历史包袱默认源里 OpenSSL 只有 1.0.2k对 Python 3.10 来说能编译但有些第三方包会对 TLS 版本做检查。我建议 CentOS 7 用户额外加 EPEL 源后安装openssl11-devel编译时再用--with-openssl指定头文件路径这个参数后面会在 configure 章节详细讲。2.4 libffi、sqlite 和 readline一批编译时不报错、用的时候才发现的模块这几个库非常容易被忽略因为它们缺失时 configure 不一定报错很多只是少编译几个扩展模块。libffi-devel提供ctypes和cffi的底层支持。很多 C 扩展在编译时需要调用 libffi缺了它import ctypes直接失败。sqlite-develPython 很多标准库操作 SQLite 数据库。如果编译时找不到 SQLite 头文件sqlite3模块就会缺失。Django 做数据库迁移、量化脚本存 tick 数据时都会用到。readline-devel影响 Python 交互模式下方向键、历史搜索CtrlR是否正常。缺少时交互式终端输入体验会非常糟糕甚至出现乱码。ncurses-devel影响终端下的curses支持写终端 UI 脚本会用到。CentOS 系安装sudo yum install -y libffi-devel sqlite-devel readline-devel ncurses-develUbuntu 系sudo apt install -y libffi-dev libsqlite3-dev libreadline-dev libncurses-dev如果你确定要用 matplotlib 的 GUI 后端或者 IDLE再顺手装tk-devel/tk-dev。这类模块一旦在编译时没有包含进去后面想要只能整趟重新编译所以我的建议是宁可多装不要少装。2.5 依赖装好之后怎么验证装完依赖后用pkg-config检查关键库的开发包是否在位pkg-config --modversion openssl pkg-config --modversion zlib pkg-config --modversion sqlite3 pkg-config --modversion libffi能正常输出版本号说明开发头文件已经装好了。如果某个命令提示No package found就回到对应小节补装。这一步值得养成肌肉记忆能帮你把问题从编译中途炸提前到编译之前就发现。3. configure / make / install 三步走那些参数到底是什么意思编译安装的核心就是三步./configure生成 Makefilemake编译make install安装。网上教程很多但我发现大部分人直接复制参数根本不理解每个参数会影响什么。这里把关键参数拆开讲。3.1 configureprefix 和优化开关是最值得花时间理解的两个点我常用的配置命令是./configure --prefix/usr/local/python3.10 --enable-optimizations --with-ensurepipinstall--prefix指定安装目录。这是最应该带着版本号的参数。我见过有人直接--prefix/usr/local装完 python3 命令和系统 Python 打架最后把系统的包管理脚本都搞坏了。正确做法是装到/usr/local/python3.10这种独立目录以后多个大版本可以共存卸载也只需要rm -rf /usr/local/python3.10。--enable-optimizations开启 PGO LTO 优化。这个参数会先编译一个基础版本跑一遍 profile 基准测试收集热点数据然后用这些数据重新编译一次最后再做链接时优化。效果是解释器整体性能能提升 10% 到 20%对跑算法、回测、数据处理这种 CPU 密集型任务非常划算。代价是编译时间会从三五分钟拉长到二十分钟甚至更久。如果你的机器性能本身就很差或者只是写点简单脚本可以不开。--with-ensurepipinstall让安装过程自动带上 pip。不加这个参数装完 Python 后还得手动下载 get-pip.py多一步就多一个踩坑点。还有两个我建议你谨慎对待的参数--enable-shared除非你确实需要在 C/C 程序里嵌入 Python 解释器否则别加。开启后会产生libpython3.10.so动态库但系统的动态链接器默认不会去/usr/local/python3.10/lib查找装完运行python3.10很可能直接报error while loading shared libraries: libpython3.10.so.1.0: cannot open shared object file到时还得去配ldconfig非常折腾。我第一次图新鲜加了它后来被迫重新编译了一趟。--with-openssl如果你用的是 CentOS 7 且装了openssl11-devel需要指定 OpenSSL 头文件路径。这一步经常被忽略却是很多人编译完 import ssl 失败的根源。比如./configure --prefix/usr/local/python3.10 --enable-optimizations --with-ensurepipinstall --with-openssl/usr/include/openssl11具体路径取决于你系统里 OpenSSL 开发包实际安装的位置可以用pkg-config --cflags openssl查一下。3.2 make 的并行度别让 PGO 把内存打爆编译阶段如果需要加速可以指定并行度make -j$(nproc)nproc是你的 CPU 核心数四核机器就相当于-j4编译速度能快不少。但这有个隐性问题开了--enable-optimizations之后PGO 阶段会临时生成大量 profile 数据文件整个编译过程的峰值磁盘占用可能到 2~3 GB内存占用也比普通编译高不少。我踩过的一次坑是一台四核 8G 内存的服务器编译时还开着 MySQL 和监控服务结果make进行到一半进程被内核 OOM 杀掉。排查了很久才发现是内存不够把并发降到-j2之后重新编译就好了。所以我的习惯是先看free -h确认内存余量再决定并发数。如果编译中途莫名其妙被杀优先怀疑内存不足把-j调低重来不用从头 configure。3.3 make install 和 make altinstall 的区别别小看这个细节很多教程直接让你make install但我不推荐。make install会安装python3、pip3这类不带版本号的命令如果配置的 prefix 路径和系统搜索路径重叠很容易覆盖系统原有的 Python 相关命令导致系统包管理器依赖的 Python 环境被污染。更稳妥的是用make make altinstallaltinstall这个名字的含义就是另一个安装它只会安装python3.10、pip3.10这种带完整版本号的命令不会去覆盖python3/pip3这种通用名字。这样系统原来的 Python 完全不受影响你的新 Python 也随时可以被python3.10精确调用。等编译完用ls /usr/local/python3.10/bin可以看到python3.10、pip3.10等一堆命令这就说明安装成功了。我一般在生产服务器上永远只用altinstall维护成本低很多。4. 装完先别急着写代码PATH、pip 和 SSL 证书这三件事装完 Python 不意味着可以立刻写代码你还需要处理几个容易半路冒出来的问题。按下面的顺序做可以避免大部分新手烦恼。4.1 把 Python 目录加进 PATH但不要乱动系统命令二进制确实装好了但 shell 默认找不到它。需要把/usr/local/python3.10/bin加进 PATH。我习惯在/etc/profile.d/下新建一个python310.shexport PATH/usr/local/python3.10/bin:$PATH保存后执行source /etc/profile.d/python310.sh然后验证which python3.10 which pip3.10为什么不直接建软链到/usr/local/bin/python3.10因为软链这种方式在你以后重装、升级、或者切换版本时需要手动维护一堆链接。直接把目录加进 PATH整目录安装、整目录删除管理成本低。如果你确实想让python3指向新版本在确认不会覆盖系统 Python 的前提下可以手动软链ln -s /usr/local/python3.10/bin/python3.10 /usr/local/bin/python3但是系统原本的/usr/bin/python3千万别去动很多发行版系统工具依赖它。4.2 pip 版本确认与国内镜像配置安装 numpy、opencv 不再超时先确认 pip 是不是正常工作python3.10 -m pip --version如果--with-ensurepip没生效需要手动安装 pipwget https://bootstrap.pypa.io/get-pip.py python3.10 get-pip.py网络环境比较尴尬的时候直连官方 PyPI 源下载大包很容易超时。numpy、pandas、opencv-python这些包动辄几十 MB超时重试非常折磨。我会在~/.pip/pip.conf里配置国内镜像[global] index-url https://mirrors.cloud.tencent.com/pypi/simple trusted-host mirrors.cloud.tencent.com清华、阿里、腾讯的源我都用过速度差异没有绝对性选一个稳定就行。要注意的是trusted-host这行相当于告诉 pip 信任这个主机不走正常的证书校验流程。内网环境这么写没什么问题但公网环境如果用的是官方源不建议为了省事把证书校验关掉。配置好之后装常用的科学计算包就是一条命令的事pip3.10 install numpy pandas opencv-pythonPython 3.10 对这些库都有预编译好的 wheel正常情况下不需要本地再装编译器。但如果你用的是第三方源或者某个包只有源码包系统里前面装的 gcc、libffi-devel 就又派上用场了——别怀疑我遇到过很多次为什么装个 pip 包还要 gcc的疑问答案就是它在编译 C 扩展。4.3 SSL 证书宁可花五分钟配置也不要关掉验证编译安装的 Python经常在pip install时报CERTIFICATE_VERIFY_FAILED这是因为解释器没有自动继承系统 CA 证书库。正规解决办法有两个一是把系统证书路径放进环境变量。CentOS 系export SSL_CERT_FILE/etc/pki/tls/certs/ca-bundle.crtUbuntu / Debian 系export SSL_CERT_FILE/etc/ssl/certs/ca-certificates.crt二是把证书路径告诉 pippython3.10 -m pip config set global.cert /etc/ssl/certs/ca-certificates.crt还有一种最省事的方式是修改 pip.conf 把verify设为false但我不建议这么做。把证书校验关掉等于把 HTTPS 的加密传输降级成裸奔中间人攻击和恶意 PyPI 仓库的风险会直接进来。编译安装是为了获得一个干净可控的环境别在安全上省事。5. 一套无坑的完整安装流程照着抄也能一次过把前面所有经验串起来这里给一套我在 CentOS / Rocky 以及 Ubuntu 上都验证过的完整流程。命令可以直接复制但建议按注释逐行理解一下。# 1. 安装依赖 # CentOS / Rocky sudo yum install -y gcc gcc-c make zlib-devel bzip2 bzip2-devel xz xz-devel libffi-devel sqlite-devel readline-devel ncurses-devel openssl-devel # Ubuntu / Debian sudo apt install -y build-essential zlib1g-dev libbz2-dev liblzma-dev libffi-dev libsqlite3-dev libreadline-dev libncurses-dev libssl-dev # 2. 下载 Python 3.10 源码以 3.10.16 为例建议去官网确认最新补丁版本 wget https://www.python.org/ftp/python/3.10.16/Python-3.10.16.tar.xz tar xf Python-3.10.16.tar.xz cd Python-3.10.16 # 3. 配置如果 openssl 在非默认路径追加 --with-openssl ./configure --prefix/usr/local/python3.10 --enable-optimizations --with-ensurepipinstall # 4. 编译并安装用 altinstall 避免覆盖系统命令 make -j$(nproc) make altinstall # 5. 验证 /usr/local/python3.10/bin/python3.10 --version /usr/local/python3.10/bin/python3.10 -c import ssl, sqlite3, ctypes, zlib; print(ssl.OPENSSL_VERSION) /usr/local/python3.10/bin/pip3.10 --version有几个细节值得单独说明。第一版本号要先确认。写这篇文章时 Python 3.10 的最新补丁版本是 3.10.16但你在实操时应该去 python.org/downloads 看一下选择最新的 3.10.x。补丁版本之间主要是 bug 修复和安全更新不用纠结选新的就行。第二源码包的校验。从官网下载源码官方页面会同时公布对应文件的 SHA256 校验值。有条件的话下载后做一次校验echo 官方给的校验值 Python-3.10.16.tar.xz | sha256sum -c -虽然绝大多数时候没问题但源码包被篡改的后果很严重多一步校验不亏。第三编译空间检查。源码解压后大概 70MB但编译中间产物在 PGO 模式下可能到 2~3GB。如果你的/tmp分区只有 1GB编译很可能在某个阶段报No space left on device。建议把编译工作区放在一个磁盘空间充足的目录用df -h先看一眼。我习惯在/opt/build这类地方编译而不是默认的/tmp。第四Ubuntu 用户注意 tk 包。如果你想直接使用idle或 matplotlib 的交互窗口上面清单里建议再加tk-devsudo apt install -y tk-devCentOS 对应的是tk-devel。这个包不影响命令行使用但如果你后面突然想用 GUI 功能那就只能重新编译了所以一般我默认就装上。6. 复盘我踩过的坑每个报错都有一条完整的排查链路编译安装用久了各种报错我基本都见了一遍。这一节不是简单甩答案而是把排查思路列出来以后你遇到类似问题知道该怎么定位。6.1 坑位一zipimport.ZipImportError: cant decompress data报错场景make进行到一半或者编译完成后第一次运行 Python 时报错提示无法解压数据连内置模块都加载不了。排查链路先确认 zlib 开发包是否安装pkg-config --modversion zlib如果没有输出说明没装。安装zlib-devel或zlib1g-dev。回到源码目录清理旧的 configure 缓存然后重新配置make distclean ./configure --prefix/usr/local/python3.10 --enable-optimizations --with-ensurepipinstall这里有一个很容易被忽略的细节只装 zlib 不重新 configure 是没有用的。我第一次踩坑时以为装上开发包就能继续 make结果 configure 缓存里仍然认为找不到 zlib折腾了很久。养成make distclean的习惯之后这种问题基本就绕开了。6.2 坑位二import ssl 直接 ModuleNotFoundError报错场景Python 编译成功了但一执行import ssl就找不到模块。pip 也提示无法访问 HTTPS 源。排查链路执行/usr/local/python3.10/bin/python3.10 -c import ssl确认模块缺失。检查系统 OpenSSL 开发包是否安装rpm -qa | grep openssl或dpkg -l | grep libssl。如果开发包已安装检查 configure 时是否指定了路径。CentOS 7 默认 OpenSSL 版本较低时需要安装openssl11-devel并在 configure 里加--with-openssl/usr/include/openssl11。重新make distclean后重新 configure、make、altinstall。特别提醒不要试图从网上下载一个_ssl模块的.so文件直接丢进 site-packages。Python 扩展模块的 ABI 必须和解释器版本严格匹配手工拷贝大概率起不来而且很容易引入未知来源的代码安全问题很大。6.3 坑位三sqlite3 模块缺失报错场景import sqlite3报错或者 Django 跑数据库迁移时提示找不到_sqlite3模块。排查链路确认 SQLite 开发包是否安装pkg-config --modversion sqlite3如果没有输出说明缺sqlite-devel或libsqlite3-dev。安装后重新编译逻辑和 zlib 一样make distclean重新 configure重新 make。编译完成后用python3.10 -c import sqlite3; print(sqlite3.sqlite_version)验证。这个坑的隐蔽之处在于configure 阶段不会因为它缺失而报错Python 的构建系统只是默默把 sqlite3 模块从编译列表里拿掉了最后给你一个看起来成功、实际缺东西的 Python。6.4 坑位四libpython3.10.so.1.0 找不到报错场景运行python3.10时报 shared object 错误。这个基本是开启--enable-shared的经典副作用。排查链路确认编译时是否加了--enable-shared。如果加了需要在动态链接器配置里添加库路径echo /usr/local/python3.10/lib /etc/ld.so.conf.d/python3.10.conf sudo ldconfig ldconfig -p | grep python3.10验证一下能不能正常运行。如果你不是非要嵌入式调用 Python更推荐的做法是去掉--enable-shared重新编译。静态链接的解释器不需要额外配置动态库路径更省心。6.5 坑位五venv 里的 pip 指向全局 pip报错场景用python3.10 -m venv myenv建了虚拟环境激活后执行pip --version显示的却是全局 pip 路径。排查思路这种情况多半是 PATH 里同时存在多个 pip 命令shell 优先找到了更靠前的那个。解决方式很简单在虚拟环境内外都统一用python3.10 -m pip而不是裸pip命令这个习惯可以避免大量的环境混淆问题。python3.10 -m venv myenv source myenv/bin/activate python -m pip --version7. 多版本共存与日常维护编译安装的最大红利在这里编译安装的好处在你需要同时维护多个 Python 大版本时体现得最明显。比如服务器上跑着旧项目用的 Python 3.8新项目需要 Python 3.10两个环境互不干扰。7.1 多版本并存的目录规划我的习惯是按大版本分目录/usr/local/python3.8/ /usr/local/python3.10/ /usr/local/python3.11/每个目录内部的 bin 都有完整的python3.x、pip3.x命令。使用时直接带版本号调用python3.10 script.py pip3.10 install requests需要给人留一个通用的python3时用软链或 PATH 优先级来控制指向不要改动系统/usr/bin/python3。7.2 版本切换工具怎么选如果你只是想要在项目之间切换 Python 版本我会优先推荐pyenv。但注意 pyenv 本质上也是用编译安装的方式构建 Python会和手动编译的目录并存。所以对于服务器这种追求稳定可控的环境我仍然倾向于手动编译加venv的方案。创建虚拟环境python3.10 -m venv /opt/myproject/venv source /opt/myproject/venv/bin/activate这样项目级别的依赖全部隔离在虚拟环境里Python 解释器本身共享你编译的那个 3.10资源利用率和维护成本都是最优的。7.3 编译安装的日常维护用久了你会碰到两个实际的小问题第一Python 补丁版本升级。比如 3.10.15 升级到 3.10.16不需要卸载旧版本直接编译新版本装到同一个/usr/local/python3.10目录。因为你用的是相对独立的 prefix 目录覆盖安装到同一个位置即可。pip3.10会用新解释器重建之前全局安装的包需要重新装一遍所以如果全局装了很多依赖升级前先用pip3.10 freeze requirements.txt备份。第二重装系统后还原。我的做法是把编译命令、依赖列表写成一个 shell 脚本放在服务器/opt/install_python310.sh。新机器上跑一遍脚本然后pip3.10 install -r requirements.txt半小时就能恢复到原样。这些脚本比任何环境即代码工具都更直接、更透明。写在最后反正我现在在新机器上装 Python 就是这一套流程先装依赖再带优化参数 configure最后 altinstall。多花二十分钟编译时间换来的却是整个开发环境的确定性和可控性。真要说还有什么建议就是别偷懒跳过前面依赖安装和 configure 参数的确认环节——把一条条验证命令留在终端历史里下次版本切换或者搬服务器的时候你会感谢现在的自己。