讲师中心 微信公众号
AI工具推荐 视频效率加速

为什么Python 3.13的实验性Free-threading版本对环境有要求?

秋静同学_2625

秋静同学_2625

发布时间:2026-07-22 09:50:26

|

365人浏览过

|

来源于php中文网

原创

Python 3.13t 不是开箱即用版本,必须禁用 pymalloc、显式指定 OpenSSL 路径、设置 PYTHONNOGIL=1 环境变量,并重编所有 C 扩展;因其自由线程模式彻底改变内存管理、SSL 链接和锁机制,依赖构建与运行时环境协同适配。

为什么python 3.13的实验性free-threading版本对环境有要求?

python3.13t 不是装完就能跑的“开箱即用”版本,它对环境有硬性要求,本质是因为自由线程模式绕开了 GIL 之后,底层内存管理、符号链接、线程调度机制都变了——这些变化不是纯 Python 层能兜住的,必须从构建和运行时环境层面配合。

为什么编译时必须禁用 pymalloc

CPython 的默认内存分配器 pymalloc 是为单线程/带 GIL 场景设计的:它给每个线程维护独立的 freelist,靠 GIL 保证安全。一旦禁用 GIL,这些 per-thread 缓存就变成竞态源。
不加 --without-pymalloc 会导致:
• make 阶段报 undefined symbol: _PyObject_Alloc
• 或运行时报 segmentation fault,尤其在频繁创建小对象(如 int、tuple)时
• 官方明确将 pymalloc 列为 No-GIL 构建的冲突项,不是可选项,是必须关掉的

为什么 OpenSSL 路径必须显式指定

Free-threaded 构建默认不继承系统 OpenSSL 的线程安全配置,尤其是 macOS 上 Homebrew 安装的 openssl@3 默认启用多线程支持,但 CPython 的链接逻辑在无 GIL 模式下无法自动探测其线程安全 API 版本。
常见现象:
• import ssl 失败,提示 ImportError: cannot import name '_ssl'
• configure 阶段 silent skip OpenSSL,导致后续 HTTPS 请求全挂
解决方式必须是:--with-openssl=/usr/local/opt/openssl(macOS)或 --with-openssl=/usr(Linux),不能依赖 auto-detect

为什么 PYTHONNOGIL=1 必须显式设置才生效

即使你编译了 --disable-gil 版本,解释器默认仍启用 GIL——这是安全兜底策略,不是 bug。
关键点:
• sys._is_gil_enabled() 返回 True 是常态,不是异常
• 必须通过环境变量 PYTHONNOGIL=1 才真正关闭 GIL
• 这个变量只在进程启动时读取一次,运行中修改无效
• 若误设为 PYTHONNOGIL=0,哪怕构建支持,GIL 也强制开启

Python Use Agent
Python Use Agent

智能执行Python任务,自动生成、执行代码并反馈结果,无需额外配置,兼容旧命令。

下载

为什么 pyenv 和 setup-python 的行为不一致

不同工具对 3.13t 的识别逻辑差异很大:
• pyenv install 3.13t 会自动下载并启用 free-threaded 构建,且默认运行时 PYTHONNOGIL=1
• GitHub Actions 的 setup-python 中 python-version: '3.13t' 仅确保安装正确二进制,但不会自动设环境变量;必须额外加 env: { PYTHONNOGIL: '1' }
• pyenv 的 3.13t 是社区打包版,而 setup-python 的 3.13t 来自官方预编译包,两者 sysconfig.get_config_var("Py_GIL_DISABLED") 值可能不同,需单独验证

立即学习“Python免费学习笔记(深入)”;

实际环境中最容易被忽略的是:所有依赖 C 扩展的包(比如 numpy、psycopg2)必须重新编译,否则即便 Python 解释器无 GIL,扩展内部仍可能因调用旧版 C API 而隐式重入全局锁,导致线程卡死或结果错乱。这不是 Python 层能控制的,必须从 wheel 构建链源头介入。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1631

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

3984

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1629

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

22937

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2807

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2847

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

1123

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

596

2023.08.10

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

0

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn