WinPython-64bit 3.9.4.0 变更全解析:从 3.9.2.0 到 3.9.4.0 的包演进与变更日志生成机制

原创2026-10-15 22:31:281,716 阅读
文章标签:包管理器开发工具CLI构建工具

WinPython-64bit 3.9.4.0 变更全解析:从 3.9.2.0 到 3.9.4.0 的包演进与变更日志生成机制

WinPython-64bit 3.9.4.0 是 WinPython 面向 Windows 平台的便携式 Python 3.9 发行版中的一次重要增量发布,其官方变更记录位于 changelogs/WinPython-64bit-3.9.4.0_History.md。本文以该 History 文档为主体,逐条解读本次发行相对上一版本 3.9.2.0 的新增、升级与移除包清单,并深入当前仓库中负责生成这份变更日志的源码实现(wppm/diff.py、winpython/build_winpython.py 等),帮助你理解"这类 History 文档从何而来、如何阅读、如何自行复现对比"。读完本文,你将能准确解读任何一份 WinPython 版本变更记录,并掌握用仓库工具自行比较任意两个包索引的方法。

一、版本背景:3.9.4.0 是什么

WinPython 的版本号由三部分拼接而成:Python 小版本(winpyver2)、构建序号与发行口味(flavor)。从 winpython/build_winpython.py 的 Step 7 可以看到,变更日志文件名由 changelog_version = f"{winpyver2}{args.release_level}" 拼出,即 WinPython{flavor}-{arch}bit-{changelog_version}.md 与对应的 _History.md。因此 3.9.4.0 = Python 3.9.4 + 构建序号 0,而 3.9.2.0 是它之前最近一次已发布的 64 位版本。

值得注意的是,从 changelogs 目录的文件清单可以确认,WinPython 并未为 Python 3.9.3 发布对应构建,版本序列直接从 3.9.2.0 跳到 3.9.4.0,因此本份 History 的开头写的是 "The following changes were made ... since version 3.9.2.0"。此外,changelogs/md5_sha1.txt 记录了该版本的下载物校验信息:Winpython64-3.9.4.0.exe(约 765 MB)为主构建,另有 dot、cod 口味以及 32 位 dot 构建,说明同一 Python 版本会按口味(flavor)产出多份发行包。

二、History 与包索引的关系:先读懂两份文档

仓库中与 3.9.4.0 相关的文档共有两份,职责完全不同:

  • changelogs/WinPython-64bit-3.9.4.0.md:完整的包索引(package index),列出该发行版当前包含的全部 Tools 与 Python 包(含版本号与简介),由 wppm 的 Distribution().generate_package_index_markdown()(见 wppm/wppm.py)生成,分为 ### Tools、### Python packages、### WheelHouse packages 三个区块;
  • changelogs/WinPython-64bit-3.9.4.0_History.md:变更日志(History),只记录相对上一版本的差异,即新增(New)、升级(Upgraded)、移除(Removed)三类。

以 Tools 为例:History 中只记录了 Nodejs v14.16.0 → v14.16.1 与 npmjs 6.14.11 → 6.14.12 两项升级,但完整包索引显示该发行版还包含未发生变化的 Pandoc 2.3。阅读 History 时如需"该版本到底有什么",必须回查配套的包索引文档——这正是 diff 生成逻辑"只输出变化、不重复未变项"的设计结果。

三、Tools 升级:Node.js 与 npm 的维护性更新

本次发行对捆绑的运行时工具做了小幅升级:

工具 版本变化 简介(文档原文)
Nodejs v14.16.0 → v14.16.1 a JavaScript runtime built on Chrome's V8 JavaScript engine
npmjs 6.14.11 → 6.14.12 a package manager for JavaScript

两者均为同一小版本内的维护性升级,不涉及架构性变化,属于 WinPython 持续跟随上游安全修复与缺陷修复的常规动作。

四、Python 包新增:25 个新成员入库

本次发行一次性新增 25 个 Python 包,覆盖工程脚手架、Git 协作、Jupyter 生态、凸优化求解、配置序列化等方向:

包名 版本 用途定位(文档简介)
arrow 1.0.3 Better dates & times for Python(日期时间处理)
binaryornot 0.4.4 判断文件是二进制还是文本的轻量纯 Python 包
cookiecutter 1.7.2 从项目模板创建项目的命令行工具(脚手架)
deprecation 2.1.0 处理自动化弃用标记的库
flit 3.2.0 面向简单包的极简打包工具
flit_core 3.2.0 Flit 的构建分发核心组件
gitdb 4.0.7 Git 对象数据库
gitpython 3.1.14 Python Git 库
inflection 0.5.1 Ruby on Rails inflector 的 Python 移植(单复数/驼峰转换)
jinja2_time 0.2.0 Jinja2 日期时间扩展
jupyter_server_mathjax 0.2.2 以 Jupyter Server 扩展形式提供的 MathJax 资源
jupyterlab_git 0.30.0 JupyterLab 的 Git 扩展对应的服务端扩展
nbdime 3.0.0 Jupyter Notebook 的差异与合并工具
poyo 0.5.0 轻量 YAML 解析器
python_slugify 4.0.1 支持 Unicode 的 Slugify 应用
qdldl 0.1.5.post0 免费的 LDL 分解例程 QDLDL
qpsolvers 1.6.1 统一 API 的二次规划求解器集合
qstylizer 0.1.10 为 PyQt4/5、PySide1/2 生成样式表的工具
quadprog 0.1.8 二次规划求解器
ruamel.yaml.clib 0.2.2 ruamel.yaml 基于 libyaml 的 C 语言读写解析实现
smmap 4.0.0 滑动窗口内存映射管理器(纯 Python 实现)
text_unidecode 1.3 最基础的 Text::Unidecode 移植
tinycss 0.4 完整而简单的 CSS 解析器
tomlkit 0.7.0 保留样式的 TOML 库
voila_gridstack 0.2.0 Voila 的 GridStack 模板

这些新增包并非孤立存在,而是围绕三条主线补齐生态:

  1. 工程化与打包:cookiecutter + flit/flit_core + poyo + jinja2_time 构成了"从模板生成项目 → 解析模板配置 → 用 Flit 打包发布"的完整链路,与仓库自身的构建方式一脉相承——README.rst 中 WPPM 的构建正是通过 python -m flit build 完成的;
  2. Git 协作与 Notebook 工作流:gitpython/gitdb/smmap 是完整的 Git 操作栈,jupyterlab_git 将其接入 JupyterLab,nbdime 则解决 Notebook 的 diff/merge 难题;
  3. 凸优化求解:qpsolvers 提供统一 API 统一调度多个求解器,quadprog 与 qdldl 分别是其中一员和底层分解例程,与本次同步升级的 cvxpy、osqp、scs 呼应,构成完整的最优化工具箱。

五、Python 包升级:121 项全面更新

本次升级了 121 个 Python 包(含解释器本身),覆盖科学计算、深度学习、可视化、Jupyter、Web、地理空间等全部主力技术栈。以下按主题分组完整列出。

5.1 解释器与核心科学计算栈

包名 版本变化 说明
Python 3.9.2 → 3.9.4 解释器本身,含标准库
numpy 1.20.1+mkl → 1.20.2+mkl 数组计算基础库(MKL 加速版)
scipy 1.6.1 → 1.6.2 科学计算库
pandas 1.2.3 → 1.2.4 数据分析与时间序列
matplotlib 3.3.4 → 3.4.1 Python 绘图包(跨小版本升级)
sympy 1.7.1 → 1.8 计算机代数系统
astropy 4.2 → 4.2.1 社区驱动的天文学工具
numba 0.53.0rc3 → 0.53.1 基于 LLVM 的 Python 编译
llvmlite 0.36.0rc2 → 0.36.0 LLVM 基础功能轻量封装(rc 转正式版)
networkx 2.5 → 2.5.1 图与网络构建分析
asteval 0.9.22 → 0.9.23 基于 ast 的安全最小化表达式求值器
pint 0.16.1 → 0.17 物理量单位模块
cython 0.29.22 → 0.29.23 C 扩展编译器
dask 2021.3.0 → 2021.4.0 并行 PyData 任务调度
distributed 2021.3.0 → 2021.4.0 Dask 分布式调度器
partd 1.1.0 → 1.2.0 可追加键值存储
zarr 2.6.1 → 2.7.1 分块压缩 N 维数组

5.2 机器学习与深度学习

包名 版本变化 说明
torch 1.8.0+cpu → 1.8.1+cpu PyTorch(CPU 版,含 GPU 加速能力)
torchvision 0.9.0+cpu → 0.9.1+cpu 图像数据集与模型
torchaudio 0.8.0 → 0.8.1 PyTorch 音频包
botorch 0.3.2 → 0.4.0 基于 PyTorch 的贝叶斯优化
gpytorch 1.2.1 → 1.4.0 PyTorch 高斯过程实现
shap 0.36.0 → 0.39.0 机器学习模型解释统一方法
nltk 3.5 → 3.6.1 自然语言工具包

5.3 凸优化求解

包名 版本变化 说明
cvxpy 1.1.10 → 1.1.12 凸优化建模 DSL
osqp 0.6.1 → 0.6.2.post0 算子分裂 QP 求解器
scs 2.1.2 → 2.1.3 分裂锥求解器

5.4 数据可视化与 GUI

包名 版本变化 说明
bokeh 2.3.0 → 2.3.1 浏览器端交互绘图
bqplot 0.12.23 → 0.12.25 Jupyter 交互绘图(d3.js + ipywidgets)
datashader 0.12.0 → 0.12.1 基于栅格聚合的可视化工具链
geoviews 1.8.1 → 1.9.1 地理/气象/海洋数据可视化
holoviews 1.14.2 → 1.14.3 标注式数据可视化
mizani 0.7.2 → 0.7.3 Scales for Python(刻度系统)
plotnine 0.7.1 → 0.8.0 图形语法(grammar of graphics)
panel 0.11.0 → 0.11.3 高层应用与仪表盘方案
pydeck 0.6.1 → 0.6.2 deck.gl 地图 widget
voila 0.2.7 → 0.2.9 以只读活 Notebook 形式提供服务
pyqtgraph 0.11.1 → 0.12.1 科学绘图与 GUI 库(跨小版本升级)
pythonqwt 0.8.3 → 0.9.0 Python Qt 绘图组件(跨小版本升级)
guiqwt 3.0.5 → 3.0.6 曲线与图像绘图工具集
qdarkstyle 2.8.1 → 3.0.2 Qt 应用深色样式表(跨小版本升级)

5.5 地理空间

包名 版本变化 说明
fiona 1.8.18 → 1.8.19 空间数据文件读写
gdal 3.2.1 → 3.2.2 地理空间数据抽象库
geopandas 0.8.2 → 0.9.0 地理 pandas 扩展(跨小版本升级)
rasterio 1.2.1 → 1.2.3 快速栅格 I/O
tifffile 2021.3.5 → 2021.4.8 TIFF 文件读写

5.6 Jupyter 生态

包名 版本变化 说明
ipython 7.21.0 → 7.22.0 交互式计算内核
ipykernel 5.5.0 → 5.5.3 Jupyter IPython 内核
ipympl 0.6.3 → 0.7.0 Matplotlib Jupyter 扩展
jupyter_client 6.1.11 → 6.2.0 Jupyter 协议实现与客户端库
jupyter_console 6.2.0 → 6.4.0 Jupyter 终端控制台
jupyter_packaging 0.7.12 → 0.9.1 Jupyter 打包工具
jupyter_server 1.4.1 → 1.6.2 Jupyter Server
jupyter_server_proxy 1.6.0 → 3.0.2 代理 Web 服务的服务器扩展(跨大版本升级)
jupyterlab 3.0.9 → 3.0.14 JupyterLab 笔记本服务器扩展
jupyterlab_lsp 3.4.1 → 3.5.0 JupyterLab 语言服务器协议集成
jupyterlab_server 2.3.0 → 2.4.0 JupyterLab Server
jupyter_bokeh 2.0.4 → 3.0.0 渲染 Bokeh 内容的 Jupyter 扩展(跨大版本升级)
nbclassic 0.2.6 → 0.2.7 作为 Jupyter Server 扩展的经典 Notebook
nbformat 5.1.2 → 5.1.3 Notebook 格式
notebook 6.2.0 → 6.3.0 基于 Web 的交互计算环境
papermill 2.3.2 → 2.3.3 Notebook 参数化与批处理执行
qtconsole 5.0.2 → 5.0.3 Jupyter Qt 控制台
terminado 0.9.2 → 0.9.3 基于 Tornado WebSocket 的终端服务

5.7 IDE 与代码质量工具

包名 版本变化 说明
spyder 4.2.3 → 5.0.1 科学 Python 开发环境(跨大版本升级)
spyder_kernels 1.10.2 → 2.0.1 Spyder 控制台内核(跨大版本升级)
astroid 2.5 → 2.5.3 带推理支持的抽象语法树
pylint 2.7.1 → 2.7.4 Python 静态检查器
isort 5.7.0 → 5.8.0 import 排序工具
yapf 0.30.0 → 0.31.0 Python 格式化器
pydocstyle 5.1.1 → 6.0.0 文档字符串风格检查器(跨大版本升级)
pygments 2.8.0 → 2.8.1 语法高亮包
coverage 5.4 → 5.5 代码覆盖率测量
pytest 6.2.2 → 6.2.3 测试框架
hypothesis 6.1.1 → 6.9.2 属性驱动测试库
ptpython 3.0.16 → 3.0.17 基于 prompt_toolkit 的 REPL
prompt_toolkit 3.0.16 → 3.0.18 交互式命令行构建库
sphinx 3.5.1 → 3.5.4 文档生成工具(reStructuredText)
prettytable 2.0.0 → 2.1.0 ASCII 表格显示库
tqdm 4.58.0 → 4.59.0 进度条

5.8 Web、异步与网络

包名 版本变化 说明
aiohttp 3.7.3 → 3.7.4.post0 异步 HTTP 客户端/服务端框架
asgiref 3.3.1 → 3.3.4 ASGI 规范与辅助代码
flask_accepts 0.17.6 → 0.17.7 Flask 输入/输出处理
flask_restx 0.2.0 → 0.3.0 Flask 快速 API 开发框架
flask_sqlalchemy 2.4.4 → 2.5.1 Flask + SQLAlchemy 集成
httpx 0.16.1 → 0.17.1 下一代 HTTP 客户端
urllib3 1.26.3 → 1.26.4 线程安全连接池 HTTP 库
aniso8601 8.1.1 → 9.0.1 ISO 8601 字符串解析
tenacity 6.3.1 → 7.0.0 重试工具库(跨大版本升级)
prometheus_client 0.9.0 → 0.10.1 Prometheus 监控客户端
chardet 3.0.4 → 4.0.0 通用编码探测器(跨大版本升级)
defusedxml 0.6.0 → 0.7.1 标准库 XML 模块的 XML 炸弹防护
soupsieve 2.2 → 2.2.1 Beautiful Soup 的 CSS 选择器实现
jsonpatch 1.28 → 1.32 应用 JSON-Patch(RFC 6902)
jsonpointer 2.0 → 2.1 定位 JSON 文档节点(RFC 6901)
python_dotenv 0.15.0 → 0.17.0 .env 文件支持

5.9 数据存取与文件处理

包名 版本变化 说明
openpyxl 3.0.6 → 3.0.7 Excel 2010 xlsx/xlsm 读写
pillow 8.1.2 → 8.2.0 Python 图像处理库
xlsxwriter 1.3.7 → 1.3.9 创建 Excel XLSX 文件
xlwings 0.22.2 → 0.23.0 Python 与 Excel 双向交互
reportlab 3.5.60 → 3.5.67 ReportLab 工具包
fs 2.4.12 → 2.4.13 文件系统抽象层
importlib_metadata 3.7.0 → 3.10.1 读取 Python 包元数据
zipp 3.4.0 → 3.4.1 pathlib 兼容的 zip 文件包装
lxml 4.6.2 → 4.6.3 libxml2/libxslt 与 ElementTree API 结合
sqlalchemy 1.3.23 → 1.4.8 数据库抽象库(跨大版本升级)
intake 0.6.1 → 0.6.2 数据加载与目录系统
datasette 0.55 → 0.56 数据探索与发布工具
regex 2020.11.13 → 2021.4.4 替代 re 的正则模块
typed_ast 1.4.2 → 1.4.3 带类型注释支持的 ast 分支
lazy_object_proxy 1.5.2 → 1.6.0 快速惰性对象代理

5.10 包管理、发布与安全

包名 版本变化 说明
pip 21.0.1 → 21.1.dev0 PyPA 推荐的安装工具
setuptools 54.1.0 → 56.0.0 下载/构建/安装/升级/卸载包
twine 3.3.0 → 3.4.1 PyPI 发布工具集
virtualenv 20.4.2 → 20.4.3 虚拟环境构建器
keyring 23.0.0 → 23.0.1 密码安全存储
cryptography 3.4.6 → 3.4.7 密码学原语与配方
pyinstaller_hooks_contrib 2020.11 → 2021.1 PyInstaller 社区维护 hooks
winpython 4.0.20210307 → 4.1.20210417 WinPython 发行工具(含 WPPM)
deprecated 1.2.11 → 1.2.12 @deprecated 装饰器

5.11 底层序列化依赖

包名 版本变化 说明
ruamel.yaml 0.16.12 → 0.17.4 保留注释/风格/键序的 YAML 解析器(跨小版本升级)

5.12 升级要点解读

在 121 项升级中,以下几处值得特别关注:

  • 解释器跃升:Python 3.9.2 → 3.9.4 直接决定整份发行版的运行时基线;
  • IDE 大版本换代:Spyder 4.2.3 → 5.0.1 与 spyder_kernels 1.10.2 → 2.0.1 同步跨大版本,意味着 WinPython 随本次发布切换到了 Spyder 5 代内核协议;
  • 核心科学栈小步快跑:matplotlib 3.3.4 → 3.4.1 跨入 3.4 系列、sqlalchemy 1.3.23 → 1.4.8 跨入 1.4 系列、torch 系列 1.8.0 → 1.8.1(CPU 构建)、numba/llvmlite 从 rc 版本转为正式版(0.53.0rc3 → 0.53.1、0.36.0rc2 → 0.36.0),说明本次发行有意收编上游候选版本转正后的稳定组合;
  • Jupyter 服务端重构推进:jupyterlab 3.0.9 → 3.0.14、jupyter_server 1.4.1 → 1.6.2、notebook 6.2.0 → 6.3.0 同步跟进 Jupyter 向 jupyter_server 统一架构迁移的节奏;
  • MKL 绑定:numpy 保持 +mkl 后缀(1.20.1+mkl → 1.20.2+mkl),表明该发行版面向科学计算,数值核心采用 Intel MKL 加速。

六、Python 包移除:2 个包退场

包名 版本 原简介
helpdev 0.7.1 快速提取 Python 环境信息
jdcal 1.4.1 儒略日与格里高利历换算

helpdev 被移除后,其环境信息提取能力可由 WinPython 自带的 pip list、python -c "import sys; print(sys.version)" 等原生手段覆盖;jdcal 的日期换算功能在 Python 3.9 标准库中已有等价能力。从 wppm/diff.py 的移除判定逻辑(old 中存在而 new 中不存在的包即标记为 Removed)看,这两个包被移出 3.9.4.0 的包索引,即不再随发行版分发。

七、源码级揭秘:这份 History 文档是如何生成的

这类 _History.md 并不是手工维护的,而是 WinPython 构建流水线 Step 7 的自动化产物。整条链路在 winpython/build_winpython.py 中实现:

  1. 先调用 wppm.Distribution().generate_package_index_markdown() 生成当前版本的完整包索引(写入 WinPython-64bit-3.9.4.0.md,并复制进 changelogs/ 目录);
  2. 再调用 wppm.diff.compare_package_indexes('3.9.4.0', searchdir=changelogs目录, flavor='', architecture=64) 生成 _History.md,输出到构建目录。

关键算法位于 wppm/diff.py,值得展开:

  • 版本发现(L129-L151):changelog_versions() 用正则 WinPython{flavor}-{architecture}bit-(.+)\.(?:txt|md)$ 扫描 changelogs/ 目录,把文件名中的版本交给 PEP 440 解析器(packaging.version.parse),无法解析为版本的文件(包括 _History 同伴)被自动丢弃——这也是为何目录里既有 WinPython-64bit-3.9.4.0.md 又有 ..._History.md 却不会相互干扰;
  • 上一版本选择(L153-L160):find_previous_version() 取"解析后小于目标版本的最大版本",因此 History 标题中的 "since version 3.9.2.0" 是自动计算出来的;
  • 行解析(L21-L36):Package 类通过正则 \[([\w\-\:\/\.\_]+)\]\(([^)]+)\) \| ([^\|]*) \| ([^\|]*) 解析包索引中的 name | version | description 行,这也是为什么包索引必须保持严格的 Markdown 表格行格式;
  • 差异分类(L61-L74):compare_packages() 以包名(归一化为 - 连字符小写形式)为键做集合差:新键 → New、键同版本不同 → Upgraded(输出 旧版本 → 新版本)、旧键消失 → Removed,三个区块依次拼装为最终文档,并以 * * * 收尾。

也就是说,只要 changelogs/ 目录里躺着各版本的完整包索引,任何人都能用仓库自带工具复现任意两版之间的 History。README 的构建说明也印证了这一点:generate_a_winpython_distropy_meta.bat winpython_builds.toml 以 winpython_builds.toml 为配置驱动整条构建(该文件定义了 dot、slim 等 flavor 与各 Python 小版本的构建矩阵)。

八、实战:如何自行对比包索引、判断更新价值

8.1 用 wppm -diff 手动对比任意两版

除构建流程外,wppm/diff.py 还提供独立命令行入口,可直接比较任意两个包索引文件或任意两个版本:

# 比较两个包索引文件(全部区块)
wppm -diff WinPython-64bit-3.9.2.0.md WinPython-64bit-3.9.4.0.md
# 或
python -m wppm.diff WinPython-64bit-3.9.2.0.md WinPython-64bit-3.9.4.0.md

# 只比较某一区块(如 python)
python -m wppm.diff file1.md file2.md --section python python

# 按版本号从 changelogs 目录比较(自动找上一版本)
python -m wppm.diff 3.9.4.0 3.9.2.0

# 把对比结果写回 changelogs 目录
python -m wppm.diff --write-changelog 3.9.4.0 3.9.2.0

注意 wppm/diff.py 对 Windows 控制台默认编码(cp1252)做了处理:因为每个升级行都带 → 箭头,脚本入口会先对 sys.stdout 执行 reconfigure(encoding="utf-8"),避免"升级箭头直接触发 UnicodeEncodeError"。

8.2 用 check_updates.py 判断"哪些更新值得跟进"

如果关心的是"发行版里某个包是否该升级",仓库根目录的 check_updates.py 给出了自动化答案。其 docstring(L1-L33)把候选更新分为五类:

  • security:当前版本存在安全公告,无条件提示,且给出"首个自身无公告"的版本(会向前探测最多 24 个发布以跳过仍带公告的版本);
  • ready:存在更新、已稳定等待超过 --min-days 天、未被 yank、有对应解释器 wheel 且依赖圈不设上限,值得采纳;
  • blocked:依赖集内的某个包要求排除了该新版本;
  • needs:没有依赖禁止它,但 wheelhouse 缺少它需要的依赖,本地构建会静默回溯到旧版;
  • too new:存在更新但"资历"不足,附等待天数。

典型用法:

python check_updates.py                          # 检查最新 3.14 slim lockfile
python check_updates.py --lock <pylock.toml> --target cp314 --min-days 21

该脚本只依赖 PyPI 的公开 JSON API(无需密钥),体现了 WinPython 维护者"以安全公告与版本成熟度双重门槛决定是否收编新包"的更新策略——这与 3.9.4.0 中 numpy/scipy 等只做小版本跟进、Spyder/JupyterLab 随上游大版本切换的做法一脉相承。

九、总结

WinPython-64bit 3.9.4.0 是一次典型的"稳中求进"发行:解释器升至 Python 3.9.4,25 个新包补齐工程脚手架、Git 协作、凸优化与 Jupyter 扩展能力,121 个包完成版本跟进(其中 Spyder 5.0.1、SQLAlchemy 1.4.8 等为跨大版本升级),并移除了 2 个可由标准库替代的包。更重要的是,这份 History 文档本身由仓库中的 wppm.diff 工具自动生成——理解了 wppm/diff.py 的版本发现、上一版本选择与差异分类算法,你就掌握了阅读任何一版 WinPython 变更记录的方法论,也能用 wppm -diff 与 check_updates.py 自行评估后续升级路径。如需查看 3.9.4.0 之后的变化,可继续阅读下一版记录 WinPython-64bit 3.9.5.0 变更日志。

登录后查看全文
winpython