Perl5 核心模块 experimental 版本冲突问题分析与解决

背景介绍

在 Perl5 开发过程中，dual-life（双重生命周期）模块是一个特殊的存在，它们既存在于 CPAN 仓库中，也被直接包含在 Perl 核心发行版中。experimental 模块就是这样一个典型的 dual-life 模块，它为 Perl 开发者提供了一种便捷的方式来使用实验性功能。

问题发现

在一次例行检查中，开发人员运行了核心差异检查工具 Porting/core-cpan-diff，发现 experimental 模块在 CPAN 上有新版本发布。当尝试使用 Porting/sync-with-cpan 工具同步更新时，测试套件中的 t/porting/cmp_version.t 出现了失败。

具体表现为 stable.pm 文件的版本号检查失败：虽然版本号显示为 0.033，但文件内容与之前版本相比发生了变化。这违反了 Perl 核心开发的一个重要原则：相同版本号的模块内容应该保持一致。

问题根源分析

通过深入调查，发现问题的根源在于开发流程的偏差：

1. 直接修改 blead 分支：正常情况下，对 dual-life 模块的修改应该先在 CPAN 上进行，然后同步到 Perl 核心代码库。但在 2024 年 5 月，有一个关于 extra_paired_delimiters 特性的修改直接提交到了 blead 分支，导致 stable.pm 的版本号被提升到 0.033，而内容发生了变化。

2. 版本号不一致：这次修改后，experimental 模块内部的两个 .pm 文件（experimental.pm 和 stable.pm）出现了版本号不一致的情况。

3. 后续 CPAN 发布：2024 年 12 月，experimental 模块的新版本 0.033 被发布到 CPAN，这次发布将两个文件的版本号统一为 0.033，但内容与之前 blead 中的 0.033 版本不同，导致了同步时的冲突。

解决方案

经过开发团队的讨论，确定了以下解决方案：

1. 发布新版本：在 CPAN 上发布 experimental 模块的新版本 0.034，确保所有文件的版本号一致且内容正确。

2. 同步到核心：待新版本发布后，使用同步工具将其更新到 Perl 核心代码库中。

3. 流程改进：考虑将 experimental 模块的上游设为 blead 分支，因为实际上大多数更新都来自核心开发而非 CPAN。

经验教训

这一事件为 Perl 核心开发提供了几个重要启示：

1. 严格遵守开发流程：对于 dual-life 模块，修改应该先在 CPAN 上进行，然后再同步到核心代码库。

2. 版本号管理：当需要修改已发布版本的内容时，应该使用开发版本号（如 0.032_001）而非正式版本号。

3. 自动化测试：核心开发中的版本检查工具（如 cmpVERSION.pl）能够有效捕捉这类问题，应该在开发过程中充分利用。

后续发展

按照解决方案，experimental 模块的新版本 0.034 已成功发布到 CPAN，并顺利同步到了 Perl 核心代码库的 blead 分支中。这一问题的解决不仅修复了当前的版本冲突，也为未来类似情况提供了处理范例。

这一事件也促使开发团队重新思考 experimental 模块的管理方式，未来可能会调整其上游设置，以更好地适应实际的开发流程。