CDS 注释类型彻底吃透：在 SAP HANA 与 HANA Cloud 的数据建模中，如何把注释用到刀刃上

写给一线的 HANA 数据建模与 XS Advanced 项目开发者：注释不是装饰，它是团队沟通、模型演进与问题定位的低成本高价值资产。

---

为何在 CDS 文档里重视注释

在 SAP HANA 的 Core Data Services 里，CDS 文档是以设计时工件的方式描述持久化模型的源头，随 HDI 构建被转换为运行时对象。规范而透明的注释策略，可以让复杂的实体、类型、视图与上下文在多人协作中保持可读、可维护，并在排错时显著降低沟通成本。SAP Help 明确给出了 CDS 支持的注释类型与语法约定，这是我们制定团队注释规范的权威依据。(SAP Help Portal)

从官方参考手册可以确认，CDS 支持四类注释：In-line、End-of-line、Complete-line