操作系统:Debian 12_x64
python版本: 3.14.0
最新发布的python3.14.0版本已经正式支持free-threading功能,可以在python中关闭GIL,更好地利用多核 CPU 的性能。
今天安装该版本进行了体验,并做了简单测试,这里整理成笔记记录下来,希望对你有帮助。
python 3.14.0发布页:
https://www.python.org/downloads/release/python-3140/

一、功能说明
从3.13版本开始,python引入了free-threading功能,其中GIL可被关闭,python线程可充分利用多核cpu资源,这里做下简单介绍。
1)通过源码安装时,需要添加 --disable-gil 标志;
2)可通过如下方式查看是否支持free-threading功能:
python -VV
sys.version
sys._is_gil_enabled()
3)线程安全方面
free-threading版本的python旨在提供与启用GIL功能python版本类似的线程安全行为,通过内部锁来实现dict、list 和 set这些内置数据类型的线程安全。
说明:官方文档建议尽量使用 threading.Lock 或其他同步原语,而不是依赖内置类型的内部锁。
更多信息请参考官方文档,可参考官方文档:
https://docs.python.org/3/howto/free-threading-python.html

二、环境准备
这里使用源码编译的方式安装python3.14.0版本,如果嫌麻烦,可直接下载预编译的二进制文件。
源码下载地址:
https://www.python.org/ftp/python/3.14.0/Python-3.14.0.tgz
预编译二级制下载地址可从页面获取:
https://www.python.org/downloads/release/python-3140/

编译时需要添加关闭gil选项:
--disable-gil
安装依赖:
apt install gcc bzip2 libssl-dev libssl3 openssl xzip lzma sqlite3 libgdbm-dev tk libffi-dev
编译及安装:
./configure --enable-optimozations --enable-shared --disable-gil --prefix=/usr/local/python314
make
make altinstall
编辑环境脚本(env.sh):
#! /bin/bash
export CFLAGS="-I/usr/local/python314/include"
export LDFLAGS="-L/usr/local/python314/lib"
export LD_LIBRARY_PATH=/usr/local/python314/lib
环境生效:
source env.sh
可以通过-VV参数查看是否支持free-threading功能:
也可通过以下方式查看是否支持free-threding功能:
sys._is_gil_enabled()
sys.version

三、测试验证
这里使用简单的多线程代码进行验证。
测试代码如下(thrdTest1.py):
import threading
import time,random
def fun(interval):
counter = 0
while True:
a=random.randint(10000,99999) * random.randint(10000,99999)
for i in range(3):
t = threading.Thread(target=fun,args=(1,))
t.daemon = True
t.start()
time.sleep(100)
启动脚本如下(start.sh):
#! /bin/bash
export CFLAGS="-I/usr/local/python314/include"
export LDFLAGS="-L/usr/local/python314/lib"
export LD_LIBRARY_PATH=/usr/local/python314/lib
/usr/local/python314/bin/python3.14 thrdTest1.py
运行效果如下:
由图可以看出:
3个线程跑满3个cpu,free-threading功能可充分发挥多核cpu优势。
四、资源获取
本文相关资源及运行环境,可从如下渠道获取:
关注微信公众号(聊聊博文,文末可扫码)后回复 20251014 获取。
