- 开发工具
- 构建工具
- CLI
- 包管理器
【免费下载链接】winpython
A free Python-distribution for Windows platform, including prebuilt packages for Scientific Python.
WinPython 是基于 Windows 平台的免费 Python 发行版，其changelogs/目录沉淀了每个版本的完整包索引与升级历史。本文以 WinPythondot-64bit-3.10.4.0_History.md 为主干，解读 dot 风味发行版从 3.10.2.0 到 3.10.4.0 的包升级明细，并深入仓库源码与测试，说明这份_History.md是如何从两份包索引自动生成的、wppm -diff怎么用、以及它和 版本包索引 之间"索引 vs 历史"的分工关系。读完本文，你将能读懂任何一份 WinPython_History.md，并会用仓库工具自行对比任意两个版本的包清单。
一、这份文档是什么：一次"索引对比"的结果
WinPython 的changelogs/目录里并存两类 Markdown 文件：
| 文件类型 | 命名示例 | 内容含义 |
|---|---|---|
| 版本包索引 | WinPythondot-64bit-3.10.4.0.md | 该版本发行包内"包含哪些软件"，按 Tools / Python packages 分类列出 Name、Version、Description 表格 |
| 升级历史 | WinPythondot-64bit-3.10.4.0_History.md | 对比"上一个版本 vs 本版本"的包索引，列出新增 / 升级 / 移除的包 |
我们聚焦的这份_History.md只有 30 行左右，但它精确地记录了 dot 系列 3.10.4.0 相比 3.10.2.0 的全部变化：5 个包被升级，0 个新增，0 个移除。这正是它的价值所在——不必手动翻两份完整索引再逐行比对。
从源码结构看，_History.md并不由构建流程直接"手工"写出，而是由 wppm/diff.py 中的compare_package_indexes()函数，以两份版本索引为输入、按### Tools/### Python packages/### WheelHouse packages三类逐节对比后自动生成的（见 wppm/diff.py）。这解释了为什么这份历史文件在"Python packages"一节下精确列出 5 个升级条目——它们就是compare_packages()中upgraded分组的直接输出。
二、升级内容逐条解读（3.10.2.0 → 3.10.4.0）
该文档"Upgraded packages"一节完整列出了 5 个升级项，逐一解读如下：
| 包 | 旧版本 | 新版本 | 说明 |
|---|---|---|---|
| Python | 3.10.2 | 3.10.4 | 解释器本体升级（含标准库） |
| pip | 21.3.1 | 22.0.4 | PyPA 官方推荐的 Python 包安装工具 |
| setuptools | 60.5.0 | 62.1.0 | 构建、下载、安装、升级、卸载 Python 包的工具链 |
| sqlite_bro | 0.12.1 | 0.12.2 | 单 Python 文件的图形化 SQLite 客户端 |
| winpython | 4.6.20220116 | 4.6.20220501 | WinPython 发行版自带工具集（含 WPPM） |
对照上一版本索引 WinPythondot-64bit-3.10.2.0.md 可知，3.10.4.0dot 完整包清单（见 WinPythondot-64bit-3.10.4.0.md）共 6 个 Python 包：除上表 5 个外，还有wheel 0.37.1（Python 的 wheel 内置包格式工具），msvc_runtime 14.29.30133也保留在包集合中（该版本索引在 Tools 一节为空表，全部内容集中在 Python packages 一节）。
三、dot 是什么：flavor（风味）在 WinPython 构建体系中的含义
文件名中的dot是 WinPython 的flavor（构建风味），它决定"一个发行版里装哪些包、带哪些工具"。当前仓库用 winpython_builds.toml 管理所有本地构建，其中每个 flavor 用requirements、source_dirs、toolsdirs三个键描述（winpython_builds.toml）：
[flavors.dot] requirements = "dot_requirements.txt" source_dirs = "packages.win-amd64" toolsdirs = "bdTools\\Tools.dot"requirements指向 dot_requirements.txt，其中仅列出最小必要集：sqlite_bro、setuptools、wheel、build，并通过##msvc_runtime注释掉 msvc_runtime（可选包）；source_dirs指向 Python 安装包的来源目录packages.win-amd64；toolsdirs指向附加工具目录bdTools\Tools.dot。
这也印证了升级历史中为什么会出现sqlite_bro、setuptools、wheel这些包——它们正是 dot flavor 需求文件明确要求安装的成员（dot_requirements.txt）。作为对照，slim风味则使用 requirements_slim.txt 与更庞大的包集。
四、_History.md是怎么生成的：源码级拆解
test_changelog_files.py 的模块 docstring 明确说明了一个关键设计决策：
构建流程不再为每个版本生成
_History.md配套文件——因为"历史"是与紧邻前一版本的对比，而 flavor 在不同周期之间来来去去，读者大约每年才升级一次；真正需要的对比是读者自行选择两份索引后的结果：wppm -diff a.md b.md（见 tests/test_changelog_files.py）。
因此本文讨论的 3.10.4.0_History 这类历史文件，其生成逻辑沉淀在 wppm/diff.py 中，核心链路如下：
PackageIndex解析索引文件，识别三类头部（### Tools、### Python packages、### WheelHouse packages）并逐行提取Name | Version | Description表格（wppm/diff.py）；compare_packages(old, new)按标准化后的包名（-→_、转小写）做集合差，得到added/upgraded/removed三组（wppm/diff.py）——升级组输出格式old_version → new_version (description)，与本历史文件逐行一致；compare_package_indexes(version2, version1, ...)负责拼装整份_History.md标题与各节内容（wppm/diff.py）；write_changelog()把它落盘为changelogs/WinPython{flavor}-{architecture}bit-{version}_History.md（wppm/diff.py）。
配套测试 tests/test_diff_versions.py 则专门守护"上一个版本"的判定逻辑：find_previous_version()只依据changelogs/中的文件名解析版本并按 PEP 440 排序，选取"最近的更早版本"。例如对dot风味、版本 3.14.7.1，它会在3.14.7.0、3.14.7.1b1、3.14.7.1三个索引中选择3.14.7.1b1作为对比基准（tests/test_diff_versions.py），因为3.14.7.0 < 3.14.7.1b1 < 3.14.7.1。
命令行用法速查
wppm/diff.py的print_usage()提供了完整命令参考（wppm/diff.py）：
# 对比两份包索引文件的全部小节（不限 flavor、不限顺序） wppm -diff file1.md file2.md # 只对比指定小节 python -m wppm.diff file1.md file2.md --section header1 header2 # 成对对比多个小节，例如 python 对 wheelhouse、tools 对 tools python -m wppm.diff file1.md file2.md --pairs python wheelhouse tools tools # 直接按版本号对比 changelogs 目录中的索引 python -m wppm.diff <version2> <version1> [searchdir] [flavor] [architecture] # 把对比结果写入 _History.md 文件 python -m wppm.diff --write-changelog <version2> <version1> [searchdir] [flavor] [architecture] [basedir]五、索引文件的结构规范（便于解析与复用）
版本索引文件（如 WinPythondot-64bit-3.10.4.0.md）的表格格式是机器可解析的：每行形如包名 \| 版本号 \| 描述，对应Package.PATTERNS中的正则（wppm/diff.py）。diff工具与相关测试都对这一格式做了严格约定：
- 空行、分隔行（
Name | Version | Description与-----|---------|------------）会被BLANKS集合跳过（wppm/diff.py）； - 无法识别的行在解析时被静默跳过，不影响整体对比；
- 头部必须是精确的三类之一，
### Tools/### Python packages/### WheelHouse packages（wppm/diff.py）。
这也是为什么 tests/test_changelog_files.py 专门用参数化用例校验文件名解析：WinPythondot-64bit-3.10.4.0.md应解析为("dot", 64, "3.10.4.0")，而_History.md配套文件、hashes_*.md、锁文件等一律被拒绝（tests/test_changelog_files.py）。文件名本身就是"上一版本"判定的唯一依据，所以命名必须严格遵循WinPython{flavor}-{arch}bit-{version}.md这一约定。
六、从升级历史到构建流水线：一条完整的证据链
要理解"为什么 3.10.4.0dot 会升级这些包"，可以沿仓库的构建体系串起一条证据链：
- 需求文件：dot flavor 的依赖面由 dot_requirements.txt 定义，
sqlite_bro、setuptools、wheel、build是必装项； - 强制与约束：mandatory_requirements.txt 固定
pip、setuptools、wppm三个强制包；constraints.txt 则是对整套包集合的版本下限约束（如setuptools>=80.9.0、sqlite_bro>=0.13.1），保证升级不会引入被限制的版本； - 构建入口：build_winpython_meta.py 读取 winpython_builds.toml，把每个
(python, flavor)组合展开成一次构建，并调用 winpython/build_winpython.py 的pip_install()以pip install --no-index --find-links=<wheelhouse>方式离线安装需求（winpython/build_winpython.py）； - 锁文件与可复现：构建后由
pip lock生成pylock.*.toml与带 SHA-256 哈希的requir.*.txt（如 winpython/portable/cycle_2026_04/requir.64-3_14_7_1dotb1.txt），generate_lockfiles()还强制校验"联网锁定 vs 本地锁定"两份结果完全一致（winpython/build_winpython.py）； - 升级体检：check_updates.py 对照 PyPI 公开 JSON 审查每个锁定包，把升级候选分为
security/ready/needs/blocked/too new五档，并输出可直接粘贴的约束升级行。
换句话说，本文读到的这份 3.10.4.0 升级历史，只是这套"定义需求 → 锁定版本 → 体检升级"流水线在 2022 年周期中的一个快照输出；今天的周期则用cycles/*.toml（如 cycles/2026_04.toml）描述 Python 版本、flavor 矩阵与发布格式。
七、如何读懂与复用任何一份_History.md
结合上述机制，阅读任一份_History.md只需三步：
- 看标题行：
History of changes for WinPython-64bit <版本><flavor>，其中<版本><flavor>即目标发行版（如3.10.4.0dot）； - 看对比基准：
since version <上一个版本><flavor>，它由find_previous_version()按 PEP 440 从changelogs/文件名自动选出； - 按节对号入座：
New packages/Upgraded packages/Removed packages三组分别对应新增、升级、移除。条目格式包名 旧版本 → 新版本 (描述)与wppm -diff输出完全同构。
若你想对比任意两个版本（包括跨 flavor），直接复用仓库工具：
# 用仓库自带的 wppm 对比两份索引 python -m wppm.diff changelogs/WinPythondot-64bit-3.10.2.0.md changelogs/WinPythondot-64bit-3.10.4.0.md # 或按版本号自动寻找"上一个版本" python -m wppm.diff 3.10.4.0 3.10.2.0 changelogs dot 64其中flavor传dot、架构传64，即可精确复现本文这份历史文件的生成过程。仓库是只读的，以上命令均只做查看与比对，不会改动任何文件。
结语
WinPythondot-64bit-3.10.4.0_History.md虽然篇幅短小，却是理解 WinPython 版本管理机制的绝佳样本：它的一端连接着 flavor 需求文件与构建流水线，另一端连接着wppm -diff的解析与对比逻辑。通过 wppm/diff.py、tests/test_diff_versions.py 与 winpython_builds.toml 这些仓库证据，我们不仅能读懂"升级了哪些包"，还能说清"这份升级报告从何而来、如何复现、如何扩展"。
- 开发工具
- 构建工具
- CLI
- 包管理器
【免费下载链接】winpython
A free Python-distribution for Windows platform, including prebuilt packages for Scientific Python.
相关推荐
Qwen3.5-4B 基于 vLLM 的部署调用实战：OpenAI 兼容 API、思考模式控制与多模态推理
Qwen3.5 4B 基于 vLLM 的部署调用实战：OpenAI 兼容 API、思考模式控制与多模态推理 本篇技术指南以 Datawhale《开源大模型食用指
开发工具构建工具CLI包管理器Podman 镜像拉取策略（--policy）全解析：always / missing / never / newer 的选择与源码实现
Podman 镜像拉取策略（ policy）全解析：always / missing / never / newer 的选择与源码实现 导读 本文围绕 Podm
开发工具构建工具CLI包管理器WinPython 3.9.0.2dot 版本历史解读：64 位 dot 风味发行版的包升级与变更日志生成机制
WinPython 3.9.0.2dot 版本历史解读：64 位 dot 风味发行版的包升级与变更日志生成机制 导读 本文以 WinPython 仓库中 cha
开发工具构建工具CLI包管理器
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
