Rust 注释的解释与标注

Beginner

This tutorial is from open-source community. Access the source code

简介

欢迎来到 注释 实验。本实验是 《Rust 程序设计语言》 的一部分。你可以在 LabEx 中练习 Rust 技能。

在本实验中,你将了解 Rust 中的注释,以及如何使用它们在源代码中提供解释和注释,以便更好地理解。

这是一个实验(Guided Lab),提供逐步指导来帮助你学习和实践。请仔细按照说明完成每个步骤,获得实际操作经验。根据历史数据,这是一个 初级 级别的实验,完成率为 100%。获得了学习者 100% 的好评率。

注释

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

下面是一个简单的注释:

// 你好,世界

在 Rust 中,惯用的注释风格是以两个斜杠开始注释,注释会一直延续到该行结束。对于跨行的注释,你需要在每行都加上 //,如下所示:

// 所以我们在这里做一些复杂的事情,长到需要
// 多行注释来完成!呼!希望这个注释能
// 解释清楚发生了什么。

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

文件名:src/main.rs

fn main() {
    let lucky_number = 7; // 我今天感觉很幸运
}

但你会更经常看到它们以这种格式使用,注释在它所注释的代码上方的单独一行:

文件名:src/main.rs

fn main() {
    // 我今天感觉很幸运
    let lucky_number = 7;
}

Rust 还有另一种注释,即文档注释,我们将在“将一个 Crate 发布到 Crates.io”中讨论。

总结

恭喜你!你已经完成了注释实验。你可以在 LabEx 中练习更多实验来提升你的技能。