在doc.go文件中链接其他包文档的最优方式及替代方案咨询

针对doc.go中不能导入未使用包但又想优雅链接其他包文档的问题，有以下几种实用方案：

注释式导入（推荐） #

在doc.go的注释块中添加导入声明，go doc工具会识别这个注释并解析包的短名称，这样你就能在文档中用短包名+类型的格式链接，同时不会触发未使用导入的编译错误：

// Package foo docs in a doc.go file
// foo uses [bar.Bar] types for doing things.
/* import "foo.com/jonathan/godoctest/bar" */
package foo

这种方式既保留了短包名的可读性，又能让go doc正确解析链接到目标包的文档。

同一模块下的相对路径引用 #

如果目标包和当前包属于同一Go模块，可以使用相对路径配合短类型名的格式，可读性比全限定路径好：

// Package foo docs in a doc.go file
// foo uses [./bar.Bar] types for doing things.
package foo

go doc会自动将相对路径解析为模块内的对应包。

别名说明+全限定路径 #

如果上述两种方式不适用，可以先在文档中说明包的别名，再使用全限定路径，兼顾可读性和链接有效性：

// Package foo docs in a doc.go file
// foo uses bar包（全称 foo.com/jonathan/godoctest/bar）的 [foo.com/jonathan/godoctest/bar.Bar] 类型处理事务。
package foo

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