← 返回卡片

原书出处

Effective Go中文版

03 注释

核验版本的摘录快照 · 导入于 2026-10-23T11:26:44.488Z

多数作为程序包的注释,但也可以用于一个表达式中,或者用来注释掉一大片代码。 程序—同时又是网络服务器—godoc,用来处理Go源文件,抽取有关程序包内容的文档。

在顶层声明之前出现,并且中间没有换行的注释,会随着声明一起被抽取,作为该项的解释性文本。这些注释的本质和风格决定了godoc所产生文档的质量。

每个程序包都应该有一个包注释,一个位于package子句之前的块注释。对于有多个文件的程序包,包注释只需要出现在一个文件中,任何一个文件都可以。包注释应该用来

此预览只包含定位所需的摘录和上下文。

原书定位详情

来源:a19c7933-4eda-4176-aebd-30fe7e1ad292

正文位置:extracted/Effective Go中文版/_epub-src/OEBPS/注释.md.html

EPUB SHA-256:0fe00b742c425a3cbfb1dcf5db8f9ab889cfbd7ca3a4e3be39bba5876b63c1c7