如何将已开发完成的Perl模块发布到CPAN平台？

1. 前置规范检查 #

• 确保你的模块目录符合CPAN标准结构：

  你的模块名-版本号/
  ├── lib/          # 存放所有编写完成的.pm模块文件，严格对应命名空间层级
  ├── t/            # 单元测试文件，后缀统一为.t
  ├── Changes       # 版本更新日志，每条记录需包含版本号、更新时间、修改内容
  ├── LICENSE       # 开源许可声明，CPAN常用Perl5原生许可、GPL、Artistic许可等
  ├── README        # 模块功能介绍、依赖说明、适用场景
  └── Makefile.PL   # 模块元数据、依赖配置文件，也可使用cpanfile、Build.PL替代
  

• 元数据必须包含：模块完整名称、版本号、作者信息、依赖项列表、最低支持Perl版本。使用ExtUtils::MakeMaker编写Makefile.PL时直接填写对应配置字段即可。

2. 本地验证测试 #

• 执行依赖检查：运行命令 perl Makefile.PL，按照提示补全所有缺失的依赖
• 执行单元测试：运行命令 make test，需保证所有测试用例全部通过，避免后续出现兼容性问题
• 生成发布包：运行命令 make dist，会自动生成.tar.gz格式的发布压缩包，同时自动校验包结构合规性
• 本地安装验证：运行命令 cpanm ./你的模块名-0.01.tar.gz，确认模块安装、调用逻辑完全正常

3. 申请PAUSE账号 #

• PAUSE是CPAN官方的作者上传管理系统，你需要先提交注册申请，填写邮箱、作者姓名、计划发布的模块名称前缀即可，审核通过后会收到包含账号密码的通知邮件。
• 注意：发布前需确认你使用的模块命名未和CPAN现有模块重名，避免命名冲突导致发布失败

4. 上传发布模块 #

• 登录PAUSE后台，直接上传之前生成的.tar.gz发布包即可，系统会自动完成包合法性校验，校验通过后进入全局索引队列。
• 正常等待1~2小时，模块就会同步到全球CPAN镜像站，用户可以直接通过cpan、cpanm等工具安装你的模块。

5. 后续版本迭代 #

• 每次更新版本时，先升级模块版本号、更新Changes日志，重新走本地测试、打发布包的流程后再上传到PAUSE，系统会自动更新全局索引为最新版本。

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