ABAP CDS 注解作用域全景：@Scope 的语义、落点与实战样例全集

这是一篇面向一线开发者的深度实践文档，聚焦 ABAP CDS 注解的 Scope（作用域）体系。你会看到 @Scope 背后的规则、在不同 CDS 工件上的落点，以及一整套可复制的端到端样例：DEFINE ANNOTATION 自定义注解、VIEW ENTITY 与 TABLE FUNCTION 的注解、ANNOTATE VIEW 元数据扩展、DCL DEFINE ROLE 的角色注解、加上一段能在 ABAP 环境直接 REPORT 运行的验证程序，帮助你把理论落到工程。

---

为什么要理解注解的作用域

在 ABAP CDS 世界里，注解是元数据的载体：描述语义、启用框架能力、改变生成行为乃至 UI 呈现。真正决定一个注解能不能、应不应该写在某个地方的关键，就是它的作用域。这个作用域并不是开发者自由发挥，而是由注解的定义端通过 @Scope 声明出来的；只有当某个注解的定义允许在某个 Scope 出现时，你才能在对应的 CDS 源码位置使用它。官方文档明确指出：注解有哪些可用作用域，由对应注解定义中的枚举值给出；且注解名在同一作用域内必须唯一。(