如何为依赖Perl库的自定义Bash命令编写规范的Makefile

1. 重构项目结构为Perl社区标准格式 #

先把现有目录改成CPAN通用结构，让MakeMaker能自动识别脚本和模块：

program/
├── bin/
│   └── program          # 把原program.pl重命名为无后缀的命令名，更符合系统命令习惯
├── lib/
│   └── Program/         # 存放自定义Perl模块，比如Program/Utils.pm、Program/Config.pm等
├── t/                   # 可选：存放测试脚本，用于验证功能
│   └── basic.t
├── Makefile.PL          # 顶层MakeMaker配置文件
└── README.md            # 项目说明文档

2. 编写顶层Makefile.PL整合安装流程 #

用ExtUtils::MakeMaker编写配置文件，同时处理脚本和模块的安装，自动适配不同Perl环境的路径：

use ExtUtils::MakeMaker;

WriteMakefile(
    NAME             => 'Program',
    VERSION          => '0.01',                  # 项目版本号
    ABSTRACT         => '自定义功能的Perl命令行工具', # 项目摘要
    AUTHOR           => '你的名字 <你的邮箱>',
    EXE_FILES        => ['bin/program'],         # 指定要安装的可执行脚本
    PREREQ_PM        => {                        # 声明所有依赖的第三方Perl模块
        'Getopt::Long' => '2.50',
        'JSON::PP'     => '4.06',
        # 列出所有脚本依赖的非核心模块
    },
    LICENSE          => 'perl',
    MIN_PERL_VERSION => '5.10.0',                # 指定最低兼容的Perl版本
);

这个配置会自动完成：

• 将bin/program安装到系统Perl的可执行目录（通常是/usr/bin或/usr/local/bin，与perl -V:installscript输出一致）
• 将lib/Program/下的模块安装到对应Perl版本的标准库路径（无需硬编码）
• 检查用户环境是否满足依赖和Perl版本要求

3. 调整脚本的模块引用逻辑 #

确保脚本能正确找到自定义模块：

• 开发阶段：在脚本开头添加临时库路径（安装后自动失效，不影响生产环境）：

use strict;
use warnings;
use FindBin qw($RealBin);
use lib "$RealBin/../lib"; # 仅开发时用，指向项目根目录的lib
use Program::Utils;        # 引用自定义模块

• 安装后：模块会被放到Perl的默认@INC路径中，脚本无需额外配置，直接use Program::Utils;即可。

4. 统一安装与测试流程 #

现在只需在项目根目录执行以下命令，完成所有安装步骤：

# 生成Makefile
perl Makefile.PL

# 构建（纯Perl模块仅复制文件）
make

# 可选：运行测试脚本验证功能
make test

# 安装（普通用户可能需要sudo）
sudo make install

如果用户习惯用CPAN工具，也可以用cpanm一键安装，自动处理所有依赖：

sudo cpanm .

5. 提升可移植性的关键要点 #

• 明确依赖：在PREREQ_PM中列全所有非Perl核心模块，避免用户安装后因缺少依赖报错
• 避免硬编码路径：完全依赖MakeMaker的自动路径适配，不写死模块或脚本的安装位置
• 指定最低Perl版本：通过MIN_PERL_VERSION过滤不兼容的旧Perl环境
• 添加测试脚本：在t/目录编写测试用例，用户运行make test可快速验证安装是否成功

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