注释

所有程序员都力求使他们的代码易于理解,但有时需要额外的解释。在这些情况下,程序员会在他们的源代码中留下编译器会忽略但阅读源代码的人可能会觉得有用的*注释*。

这是一个简单的注释

#![allow(unused)]
fn main() {
// hello, world
}

在 Rust 中,惯用的注释风格使用两个斜杠开始注释,注释一直持续到行尾。对于超过一行的注释,你需要在每一行都包含 //,如下所示

#![allow(unused)]
fn main() {
// So we’re doing something complicated here, long enough that we need
// multiple lines of comments to do it! Whew! Hopefully, this comment will
// explain what’s going on.
}

注释也可以放在包含代码的行尾

文件名:src/main.rs

fn main() {
    let lucky_number = 7; // I’m feeling lucky today
}

但你会更常见到它们以这种格式使用,注释位于它所注释的代码之上的单独一行

文件名:src/main.rs

fn main() {
    // I’m feeling lucky today
    let lucky_number = 7;
}

Rust 还有另一种注释,文档注释,我们将在第 14 章的“将 Crate 发布到 Crates.io”部分讨论。