Mac OS Big Sur下Perl脚本引入自定义.pm模块提示@INC中找不到模块

Can't locate MyPerlModule.pm in @INC
(@INC contains: /Library/Perl/5.30/darwin-thread-multi-2level /Library/Perl/5.30 /Network/Library/Perl/5.30/darwin-thread-multi-2level /Network/Library/Perl/5.30 /Library/Perl/Updates/5.30.2 /System/Library/Perl/5.30/darwin-thread-multi-2level /System/Library/Perl/5.30 /System/Library/Perl/Extras/5.30/darwin-thread-multi-2level /System/Library/Perl/Extras/5.30)

• 路径书写问题：如果使用相对路径指定模块目录，脚本执行时的工作目录和预期不一致，会导致路径无法被正确识别追加到@INC。
• SIP权限限制：Mac OS Big Sur强化了系统自带Perl的运行限制，如果自定义模块放在用户目录、桌面等受权限保护的位置，系统Perl进程没有读取权限，即便路径写对也会表现为路径未加入@INC。
• 代码顺序错误：use lib或者BEGIN { push @INC, 路径 }语句必须写在所有use MyPerlModule语句之前，否则Perl会先执行模块加载逻辑，再修改@INC，自然报找不到模块的错误。

1. 优先使用绝对路径指定模块目录，同时添加调试代码验证路径有效性，且用unshift代替push把自定义路径放在@INC最前面，避免同名系统模块冲突：

use Cwd qw(getcwd);
print "当前工作目录：" . getcwd() . "\n";
my $module_path = "/替换为你的模块所在的绝对路径";
print "模块路径是否存在：" . (-e $module_path ? "是" : "否") . "\n";

# 路径配置必须放在加载自定义模块之前
BEGIN {
    my $module_path = "/替换为你的模块所在的绝对路径";
    unshift @INC, $module_path;
}
use MyPerlModule;

2. 规避系统Perl的权限限制，通过Homebrew安装独立Perl版本，执行命令brew install perl，安装完成后用which perl确认调用的是/usr/local/bin/perl（Intel芯片）或者/opt/homebrew/bin/perl（M系列芯片），而非系统默认的/usr/bin/perl。
3. 如果必须使用系统自带Perl，将自定义.pm模块移动到@INC默认包含的可写目录/Library/Perl/5.30下，无需额外修改@INC即可直接加载模块。

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