单元声明的角色遇use子句时声明器块失效？是否为Bug？

首先明确：单元角色（unit role）本身是支持使用声明器块（也就是#|单行文档注释）的，但你的代码写法导致文档没有被正确关联到Baz角色上，同时这个场景下可能存在Raku的文档解析bug。

问题原因分析 #

你代码中的#| Why for Baz被Raku解析为了前面use Foo;语句的文档，而不是后面的unit role Baz。这是因为Raku的#|单行注释是绑定到紧接它的下一个语法实体，而use Foo;是一个完整的执行语句，所以注释被“附着”到了use语句上，而非目标角色。

修正后的写法 #

要让文档正确关联到单元角色，你有两种可行的方式：

方式1：使用多行Pod块明确指定文档

这种方式更清晰，也不容易出现解析问题：

use Foo;

=begin pod
=head1 WHY
Why for Baz
=end pod

unit role Baz does Foo;
method quux { "quux" }

方式2：调整#|注释的位置（若单行注释更符合你的习惯）

确保#|紧跟在unit role声明的上方，并且中间没有其他干扰语句（不过根据反馈，这个写法可能在部分Raku版本中仍存在解析问题）：

use Foo;
#| Why for Baz
unit role Baz does Foo;
method quux { "quux" }

关于Bug的可能性 #

如果你已经按照正确的位置放置了注释，但仍然无法通过Baz.WHY获取文档，那这大概率是Raku的文档解析bug——单元角色在前置use子句的场景下，单行文档注释的关联逻辑可能存在问题。你提交Bug报告的做法完全正确，官方团队后续应该会修复这个问题。

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