cargo doc --open 命令来构建所有本地依赖提供的文档并在浏览器中打开。例如，假设你对 rand crate 中的其他功能感兴趣，你可以运行 cargo doc --open 并点击左侧导航栏中的 rand。 新增加的第二行代码打印出了秘密数字。这在开发程序时很有用，因为可以测试它，不过在最 终版本中会删掉它。如果游戏一开始就打印出结果就没什么可玩的了！ 尝试运行程序几次： $ cargo 、或者如示例 7-1 所示的函数。 通过使用模块，我们可以将相关的定义分组到一起，并指出它们为什么相关。程序员可以通过 使用这段代码，更加容易地找到他们想要的定义，因为他们可以基于分组来对代码进行导航， 而不需要阅读所有的定义。程序员向这段代码中添加一个新的功能时，他们也会知道代码应该 放置在何处，可以保持程序的组织性。 在前面我们提到了，src/main.rs 和 src/lib.rs 叫做 文档放入 target/doc 目录。 为了方便起见，运行 cargo doc --open 会构建当前 crate 文档（同时还有所有 crate 依赖的文 档）的 HTML 并在浏览器中打开。导航到 add_one 函数将会发现文档注释的文本是如何渲染 的，如图 14-1 所示： 302/562Rust 程序设计语言 简体中文版 图 14-1：add_one 函数的文档注释 HTML 常用（文档注释）部分