# 查看模块信息
cpanm --info Mojolicious

# 查看模块依赖
cpanm --showdeps Mojolicious

# 查看已安装模块
perldoc -l Mojolicious
perl -MMojolicious -e 'print $Mojolicious::VERSION, "\n"'

# 从 GitHub 安装
cpanm git://github.com/user/repo.git

# 从 URL 安装
cpanm https://example.com/Module-1.00.tar.gz

# 安装开发版本
cpanm --dev Module::Name

# 只下载不安装
cpanm --look Module::Name    # 下载并进入目录

# 强制重新安装
cpanm --force Module::Name

# 使用特定镜像
cpanm --mirror https://mirrors.aliyun.com/CPAN/ Module::Name

# 测试后安装
cpanm --test-only Module::Name

# 从本地目录安装
cpanm ./My-Module-1.00.tar.gz

# 安装指定版本
cpanm Module::[email protected]

# 从 cpanfile 安装所有依赖
cpanm --installdeps .

# 详细输出
cpanm -v Module::Name

# 仅安装缺失的依赖
cpanm --with-develop --installdeps .

# 安装 cpm
cpanm App::cpm

# 并行安装（比 cpanm 快 5-10 倍）
cpm install Module::Name

# 从 cpanfile 安装
cpm install --cpanfile cpanfile

cpanm App::cpan-outdated

# 列出所有过期模块
cpan-outdated

# 一键升级
cpan-outdated | cpanm

# 1. 下载
wget https://cpan.metacpan.org/authors/id/A/AU/AUTHOR/Module-1.00.tar.gz

# 2. 解压
tar xzf Module-1.00.tar.gz
cd Module-1.00

# 3. 配置
perl Makefile.PL
# 或者
perl Build.PL

# 4. 构建
make
# 或者
./Build

# 5. 测试
make test
# 或者
./Build test

# 6. 安装
sudo make install
# 或者（用户目录）
make install PREFIX=~/perl5

# 使用 local::lib 设置本地模块路径
cpanm local::lib
eval $(perl -I ~/perl5/lib/perl5 -Mlocal::lib)

# 添加到 .bashrc
echo 'eval $(perl -I ~/perl5/lib/perl5 -Mlocal::lib)' >> ~/.bashrc

# 添加额外的模块搜索路径
export PERL5LIB="$HOME/mylibs:$PERL5LIB"

# 脚本内添加
use lib "/home/user/mylibs";
use lib "/opt/perl/site/lib";

cpanm Dist::Zilla
dzil new My-New-Module

# 生成的目录结构
My-New-Module/
├── lib/
│   └── My/
│       └── New/
│           └── Module.pm
├── t/
│   └── basic.t
├── dist.ini          ← Dist::Zilla 配置
├── Changes
├── LICENSE
└── README.md

name    = My-New-Module
author  = Your Name <[email protected]>
license = Perl_5
copyright_holder = Your Name

[@Basic]

[Prereqs]
Moo             = 2.0
JSON::XS         = 4.0

[Prereqs / TestRequires]
Test::More       = 0.96

[AutoPrereqs]
[PodWeaver]
[NextRelease]

# 检查发行版
dzil test

# 构建
dzil build

# 发布到 CPAN
dzil release

# cpanfile — 项目依赖声明

# 核心依赖
requires 'perl', '5.026';
requires 'Mojolicious', '>= 9.0';
requires 'JSON::XS';
requires 'DBI';
requires 'DBD::SQLite';
requires 'Log::Log4perl';

# 可选依赖
recommends 'EV';              # 更快的事件循环
recommends 'IO::Socket::SSL'; # HTTPS 支持

# 开发依赖
on 'develop' => sub {
    requires 'Perl::Tidy';
    requires 'Perl::Critic';
    requires 'Dist::Zilla';
};

# 测试依赖
on 'test' => sub {
    requires 'Test::More', '>= 0.96';
    requires 'Test::Deep';
    requires 'Test::Exception';
    requires 'Test::Mojo';
};

# 安装生产依赖
carton install

# 安装所有依赖（含开发）
carton install --with-develop

# 使用本地依赖运行
carton exec perl myapp.pl

# 锁定依赖版本
carton install
# 生成 cpanfile.snapshot（提交到 Git）