testing - go(golang)测试框架中的 "examples"有什么意义？

Question

我最近在阅读 testing and examples在 go 测试框架中，并没有真正理解它们的用途。我看到文档说:

The package also runs and verifies example code. Example functions may include a concluding line comment that begins with "Output:" and is compared with the standard output of the function when the tests are run. (The comparison ignores leading and trailing space.)

但是，我真的不明白这会存在的原因。在我编写测试时，似乎应该更清楚如何通过阅读单元测试和基准测试来使用代码。示例部分提供了哪些额外的动机？这对我来说似乎是多余的，但是，我相信 go 的发明者有充分的理由，特别是因为他们似乎通过他们的语言设计来体现良好的编程实践。我希望了解他们的动机或如何在 golang 项目中以积极的方式使用这部分语言! :)

Answer 1

在 Go 中，源代码还用于生成文档。示例不是用于测试，而是用于文档。通过编译示例，您可以确保它们对任何使用它们的人都能正常工作。

使用golang.org 时，标准库中的示例可以直接在浏览器中运行浏览文档。 Godoc.org而是将您的示例代码直接链接到 play.golang.org您可以在哪里试用。

作为示例或示例用法，请参阅:http://golang.org/pkg/sort/