如何为CPAN::Mini镜像索引同一模块的多个版本？

我之前搭建本地CPAN镜像时也碰到过一模一样的问题——明明已经把多个版本的模块注入进去了，索引文件里也能查到条目，但cpanm就是只能下载最新版。咱们来拆解问题根源，然后一步步解决：

问题本质 #

你遇到的核心问题来自两个点：

1. CPAN工具的默认行为：CPAN::Mini::Inject、OrePAN2这类工具默认会在生成索引时只保留每个模块的最新版本，旧版本条目会被自动覆盖；
2. 手动索引的生效问题：如果你手动编辑了02packages.details.txt，但没有重新生成对应的gzip压缩文件，cpanm读取的还是旧的压缩索引，自然看不到你添加的旧版本条目。

具体解决方案 #

1. 让CPAN::Mini::Inject保留旧版本 #

首先修改你的~/.mcpani/config配置文件，添加keep_old参数并设为1，这样工具在更新索引时就不会删除旧版本的条目：

[CPAN::Mini::Inject]
local: ~/CPAN
remote: http://www.cpan.org
keep_old: 1

之后再执行mcpani --update，索引里就会保留所有你注入过的版本了。

2. 手动编辑索引后的正确操作 #

如果你已经手动修改了02packages.details.txt，一定要重新生成压缩文件，否则cpanm读不到你的修改：

cd ~/CPAN/modules
gzip -f 02packages.details.txt

这里的-f参数会强制覆盖原来的gz文件，确保新的索引生效。

3. 验证索引格式正确性 #

检查02packages.details.txt里的条目格式是否符合规范，每个条目必须是：

模块名 版本号 作者路径/模块包.tar.gz

你的条目格式是对的：

Foo 0.002 D/DU/DUMMY/Foo-0.002.tar.gz
Foo 0.001 D/DU/DUMMY/Foo-0.001.tar.gz

只要版本号符合Perl的版本规范（你的示例没问题），就不会有格式问题。

4. cpanm指定版本的正确姿势 #

确保你用file://协议指定本地镜像，避免某些环境下的路径解析错误：

cpanm -M file://~/CPAN Foo@0.001

5. 换用OrePAN2的简化方案 #

如果你试了多个工具都有同样问题，OrePAN2默认支持保留所有注入的版本，操作更简单：

• 注入两个版本的模块：

orepan2-inject Foo-0.001.tar.gz ~/CPAN
orepan2-inject Foo-0.002.tar.gz ~/CPAN

• 生成包含所有版本的索引：

orepan2-index --write-02packages ~/CPAN

之后直接用cpanm指定版本下载就行，不需要额外配置。

验证步骤 #

先确认索引里确实有两个版本的条目：

zgrep '^Foo\s' ~/CPAN/modules/02packages.details.txt.gz

如果输出里能看到两个版本的记录，再执行下载命令，应该就能成功获取指定版本的模块了。

内容的提问来源于stack exchange，提问作者j1n3l0