文档标签: Use not Comments Class Function Namespace const Code int File 系统标签: guide style google header 代码 files GoogleC++StyleGuideRevision3.180BenjyWeinbergerCraigSilversteinGregoryEitzmannMarkMentovaiTashanaLandrayEachstylepointhasasummaryforwhichadditionalinformationisavailablebytogglingtheaccompanyingarrow...
通常,好的注释应该解释为什么存在某些代码,而不应该解释某些代码在做什么。如果代码不够清晰,无法解释自身,则应使简化代码。也有一些例外情况(例如,正则表达式和复杂算法通常会在注释中解释它们的作用,会让阅读代码的人受益匪浅),但大多数注释是针对代码本身可能无法包含的信息,比如这些代码背后的缘由。 查看此 CL 之前...