Mac Perlbrew环境下无法编译Perl GD模块求助

环境信息 #

• 系统：Mac OS 12
• Perl环境：Perlbrew管理的Perl 5.36
• 前置操作：已通过Homebrew安装libgd，且尝试将/usr/local/lib加入PKG_CONFIG_PATH环境变量

安装错误日志 #

使用cpanm安装GD模块时触发如下错误：

cpanm (App::cpanminus) 1.7046 on perl 5.036000 built for darwin-2level
Work directory is /Users/mjb/.cpanm/work/1673722431.48328
You have make /usr/bin/make
You have LWP 6.67
You have /usr/bin/tar: bsdtar 3.5.1 - libarchive 3.5.1 zlib/1.2.11 liblzma/5.0.5 bz2lib/1.0.8 
You have /usr/bin/unzip
Searching install () on cpanmetadb ...
install is up to date. (0.01)
Searching GD () on cpanmetadb ...
--> Working on GD
Fetching http://www.cpan.org/authors/id/R/RU/RURBAN/GD-2.76.tar.gz
--> OK
Unpacking GD-2.76.tar.gz
Entering GD-2.76
Checking configure dependencies from META.json
Checking if you have ExtUtils::Constant 0.22 ... Yes (0.25)
Checking if you have ExtUtils::PkgConfig 0 ... Yes (1.16)
Configuring GD-2.76
Running Makefile.PL
Notice: Type perl Makefile.PL -h for command-line option summary.

Package gdlib was not found in the pkg-config search path.
Perhaps you should add the directory containing `gdlib.pc'
to the PKG_CONFIG_PATH environment variable
No package 'gdlib' found
 at Makefile.PL line 530.
*** can not find package gdlib
*** check that it is properly installed and available in PKG_CONFIG_PATH
 at Makefile.PL line 530.
--> N/A
--> FAIL Configure failed for GD-2.76. See /Users/mjb/.cpanm/work/1673722431.48328/build.log for details.

已尝试但无效的操作 #

• 在系统Perl环境中成功编译安装过GD模块
• 通过Homebrew安装libgd
• 将/usr/local/lib添加到PKG_CONFIG_PATH

1. 定位libgd的pkg-config文件 #

Homebrew安装的libgd，gdlib.pc文件不在/usr/local/lib，而是在pkgconfig子目录。先找到具体路径：

# Intel架构Mac执行
find /usr/local -name gdlib.pc
# Apple Silicon架构Mac执行
find /opt/homebrew -name gdlib.pc

2. 正确配置PKG_CONFIG_PATH #

根据上一步找到的路径，临时设置环境变量后再安装：

# 示例：Intel Mac路径
export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:$PKG_CONFIG_PATH"
# 示例：Apple Silicon Mac路径
export PKG_CONFIG_PATH="/opt/homebrew/lib/pkgconfig:$PKG_CONFIG_PATH"

# 执行安装
cpanm GD

如果要永久生效，将上述export命令添加到你的shell配置文件（如~/.zshrc或~/.bash_profile），然后执行source ~/.zshrc（或对应文件）加载配置。

3. 手动指定libgd路径安装 #

如果pkg-config仍无法识别，直接给Makefile.PL指定libgd的库和头文件路径：

# 先下载GD源码包并进入目录
cpanm --look GD
# 在解压后的目录中执行：
# Intel Mac
perl Makefile.PL --lib=/usr/local/lib --inc=/usr/local/include
# Apple Silicon Mac
perl Makefile.PL --lib=/opt/homebrew/lib --inc=/opt/homebrew/include

# 编译安装
make && make test && make install

4. 验证Perlbrew环境的环境变量 #

Perlbrew可能会隔离部分系统环境变量，检查当前Perlbrew环境下的PKG_CONFIG_PATH：

echo $PKG_CONFIG_PATH

如果未包含libgd的pkgconfig路径，确保步骤2中的配置已写入shell配置文件，且Perlbrew加载了这些变量。

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