How do you comment code in Dart?

在Dart中，注释代码是一种在代码中加入说明但不影响程序运行的方法。注释可以帮助开发者理解代码的意图和功能，也方便团队合作时的沟通。Dart支持三种类型的注释：

1. 单行注释
2. 多行注释
3. 文档注释

单行注释

单行注释以 // 开始，这种注释只影响它后面的内容直到行尾。例如：

dart
// 这是一个单行注释
int a = 5; // 这也是单行注释，它跟在代码后面

多行注释

多行注释以 /* 开始并以 */ 结束。这种注释可以跨越多行，适合注释掉大块的代码或提供详细的说明。例如：

dart
/* 这是一个多行注释的示例
   你可以在这里添加多行文字
   来描述复杂的代码逻辑或者其他信息 */
int b = 10;

文档注释

文档注释是用来生成代码文档的，它以 /// 或 /** ... */ 开始。这类注释通常用于说明类、函数、变量的用途和工作方式。例如：

dart
/// 使用 `addNumbers` 函数来计算两个数的和
/// 这个函数接收两个整数并返回它们的总和
int addNumbers(int num1, int num2) {
  return num1 + num2;
}

或者使用多行文档注释：

dart
/**
 * 检查数字是否为负数
 * 如果数字小于0，则返回true，否则返回false
 */
bool isNegative(int number) {
  return number < 0;
}

通过这些方法，你可以在Dart编程时有效地添加注释来提高代码的可读性和可维护性。使用恰当的注释能够帮助其他开发者更快地理解你的代码意图，特别是在团队协作和大型项目中。