Perl 编码风格¶

此文件使用 Perl 特定内容扩展 common/coding-style.md。

标准¶

• 始终使用 use v5.36（启用 strict、warnings、say 和子程序签名）
• 使用子程序签名 — 不要手动展开 @_
• 优先使用 say，而不是带显式换行的 print

不可变性¶

• 对所有属性使用 Moo 的 is => 'ro' 和 Types::Standard
• 不要直接使用 blessed 哈希引用 — 始终使用 Moo/Moose 访问器
• OO 覆盖说明：带有 builder 或 default 的 Moo has 属性可作为计算得到的只读值被允许

格式化¶

使用以下配置的 perltidy：

-i=4    # 4空格缩进
-l=100  # 100字符行宽
-ce     # cuddled else
-bar    # 左花括号始终靠右

代码检查¶

使用 perlcritic，主题为 core、pbp、security，严重级别为 3。

perlcritic --severity 3 --theme 'core || pbp || security' lib/

参考¶

技能：在 perl-patterns 中查看全面的现代 Perl 惯用法和最佳实践。