如何配置Makefile.PL、meta.json的OS专属prereqs禁止Windows安装Perl模块及Dist::Zilla适配方案

基于ExtUtils::MakeMaker的传统Makefile.PL配置 #

和你提到的反向场景（仅适配Windows时通过声明Win32模块依赖实现环境约束）逻辑完全对称，这套方案实现两层拦截，从根源避免Windows环境的安装失败、测试失败记录：

• 第一层：元数据声明拦截（对CPAN/CPAN Testers生效）
  在WriteMakefile的参数里通过META_MERGE合并标准META spec定义的OS支持列表，CPAN生态、CPAN Testers会自动识别该声明，不会在Windows环境下发起到你的模块的测试请求，从源头避免无意义的测试失败上报。
  对应配置代码示例：

  WriteMakefile(
    NAME => 'Your::Module',
    # ... 其他原有配置项
    META_MERGE => {
      requires => {
        os => [qw(darwin linux freebsd openbsd netbsd dragonfly)], # 列出模块实际支持的所有操作系统
      },
    },
  );
  

• 第二层：安装流程硬拦截（对手动/自动安装生效）
  在Makefile.PL文件的最开头加入前置环境判断，只要检测到Windows环境，直接终止安装流程并抛出明确的错误提示，不会进入生成Makefile、运行测试用例的环节，完全避免测试阶段的崩溃：

  # Makefile.PL 顶部前置判断逻辑
  if ($^O eq 'MSWin32') {
    die "本模块不支持Windows系统环境，无法完成安装或运行\n";
  }
  

基于Dist::Zilla的dist.ini配置 #

迁移到Dist::Zilla构建体系后，不需要手写重复的判断逻辑和元数据字段，直接通过官方生态的现成插件实现和上面完全一致的两层拦截效果：

• 推荐使用Dist::Zilla::Plugin::CheckOS插件，在dist.ini中加入配置即可：

  [CheckOS]
  skips = MSWin32 ; 列出需要拦截的操作系统对应的$^O标识
  

  该插件会自动完成两项工作：
  • 在生成的发行包元数据中写入标准OS支持声明，让CPAN、CPAN Testers自动跳过Windows环境的测试
  • 在安装配置阶段自动运行环境检查，遇到被拦截的OS直接抛出明确错误，不会进入测试流程
• 如果不想依赖额外插件，也可以通过元数据合并的方式手动写入OS声明，仅实现CPAN Testers的跳过效果，没有安装阶段的硬拦截：

  [MetaJSON]
  merge = { "requires": { "os": ["darwin", "linux", "freebsd"] } }
  

注意事项 #

• 不要靠依赖某个非Windows专属的CPAN模块实现拦截逻辑，这类方案可靠性差，只要对应的模块被移植到Windows环境，拦截规则就会失效
• 拦截抛出的错误信息需要明确说明是模块本身的适配限制，避免用户误以为是代码故障

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