Linux 透過 CPAN 安裝 Perl 模組完整指南：從基礎到 Proxy 設定

CPAN (Comprehensive Perl Archive Network) 是 Perl 模組的中央倉庫，提供數萬個可直接安裝的擴充套件。本文涵蓋 互動式 Shell、單行指令、系統套件管理器安裝 CPAN 本體、Proxy 設定 等完整流程，適用於 CentOS/RHEL/Fedora、Debian/Ubuntu 等主流發行版。

前置需求：C 編譯環境

大部分 XS 模組需編譯 C 程式碼，請先安裝開發工具鏈：

# CentOS/RHEL/Fedora
sudo dnf groupinstall "Development Tools"   # 或 yum groupinstall

# Debian/Ubuntu
sudo apt update && sudo apt install build-essential

方法一：互動式 CPAN Shell（推薦新手）

sudo perl -MCPAN -e shell
# 首次執行會進入設定精靈，建議選 "follow" 自動處理相依性
cpan> install HTML::Template
cpan> quit

方法二：單行指令（適合腳本自動化）

sudo perl -MCPAN -e 'install HTML::Template'
# 或指定版本
sudo perl -MCPAN -e 'install HTML::Template==2.97'

方法三：系統套件管理器安裝 CPAN 工具

若出現 Can't locate CPAN.pm in @INC，表示系統缺少 CPAN 核心模組：

Proxy 環境下的 CPAN 設定

sudo perl -MCPAN -e shell
cpan> o conf init /proxy/
# 依提示輸入 proxy_host、proxy_port、proxy_user、proxy_pass
cpan> o conf commit

或直接編輯 ~/.cpan/CPAN/MyConfig.pm：

'proxy_host' => q[proxy.example.com],
'proxy_port' => q[3128],
'proxy_user' => q[username],
'proxy_pass' => q[password],

常用 CPAN Shell 指令速查

替代方案：cpanminus (cpanm) — 更輕量、更快速

# 安裝 cpanm
curl -L https://cpanmin.us | perl - App::cpanminus
# 使用
cpanm HTML::Template
cpanm --mirror https://cpan.metacpan.org --mirror-only HTML::Template  # 指定鏡像

cpanm 相依性解析更快、輸出更乾淨，建議作為日常首選工具。

注意事項

• 系統 Perl (/usr/bin/perl) 安裝的模組屬系統層級，避免污染建議使用 perlbrew 或 plenv 管理獨立 Perl 環境。
• 生產環境請先在測試機驗證模組相容性，再納入部署腳本。
• 定期執行 cpanm --self-upgrade 保持工具最新。

掌握 CPAN 與 cpanm 操作，即可輕鬆擴展 Perl 功能，加速開發與維運自動化腳本撰寫。