单行注释
用 // 开头,适合简短说明。
// 这是一个单行注释
var name = "Alice"; // 也可以写在语句后面
多行注释
用 /* ... */,适合一段较长说明。
/*
这是多行注释
可以写多行文字
*/
var age = 20;
文档注释
用 ///(单行)或 /** ... */(多行),用于生成文档。
它们可以被 Dart 的文档生成工具(dartdoc)识别。
/// 计算两个数的和
///
/// [a] 第一个数
/// [b] 第二个数
/// 返回它们的和
int sum(int a, int b) => a + b;
/**
* 这是多行文档注释
* 也能生成 API 文档
*/