You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.
## 注释
> [ch03-04-comments.md](https://github.com/rust-lang/book/blob/main/src/ch03-04-comments.md)
> <br>
> commit d0acb2595c891de97a133d06635c50ab449dd65c
所有程序员都力求使其代码易于理解，不过有时还需要提供额外的解释。在这种情况下，程序员在源码中留下 ** 注释**（
这是一个简单的注释：
```rust
// hello, world
```
在 Rust 中，惯用的注释样式是以两个斜杠开始注释，并持续到本行的结尾。对于超过一行的注释，需要在每一行前都加上 `//` ，像这样：
```rust
// So we’
// multiple lines of comments to do it! Whew! Hopefully, this comment will
// explain what’
```
注释也可以放在包含代码的行的末尾：
< span class = "filename" > 文件名： </ span >
```rust
{{ #rustdoc_include ../ listings / ch03 - common - programming - concepts / no - listing - 24 - comments - end - of - line / src / main . rs }}
```
不过你更经常看到的是以这种格式使用它们，也就是位于它所解释的代码行的上面一行：
< span class = "filename" > 文件名： </ span >
```rust
{{ #rustdoc_include ../ listings / ch03 - common - programming - concepts / no - listing - 25 - comments - above - line / src / main . rs }}
```
Rust 还有另一种注释，称为文档注释，我们将在 14 章的 [“将 crate 发布到 Crates.io” ][publishing]部分讨论它。
[publishing]: ch14-02-publishing-to-crates-io.html
