Flutter与Dart中下划线(_)的含义及使用规则是什么？

在Dart（以及Flutter开发场景中），下划线是具备明确语法意义的符号，核心用法分为以下几类：

1. 库级私有成员标识 #

这是最常用的语法特性：Dart没有public/private关键字，以下划线开头的标识符（属性、方法、类、顶级变量等）会被标记为库级私有，仅能在当前.dart文件（即同一个库）内访问，其他文件无法直接调用。

示例：

// user.dart 文件
class User {
  // 私有属性，仅当前文件可访问
  String _password;

  User(this._password);

  // 私有方法，仅当前文件可调用
  bool _isPasswordValid() {
    return _password.length >= 6;
  }

  bool canLogin() {
    // 类内部可正常调用私有方法
    return _isPasswordValid();
  }
}

// 同一个文件内的其他类可以访问User的私有成员
class Admin {
  void resetUserPassword(User user) {
    user._password = 'new123'; // 合法，因为在同一个文件
  }
}

注意：这是库级私有而非类级私有，和Java等语言的private语义存在差异。

2. 忽略不需要的变量 #

在解构赋值、遍历或处理返回值时，下划线用于表示“不需要这个变量”，避免定义无意义的变量名。

示例：

• 解构列表/映射：

var coordinates = [10.0, 20.0, 30.0];
var [_, y, _] = coordinates; // 仅获取y坐标，忽略x和z

var userInfo = {'id': 1, 'name': 'Bob', 'email': 'bob@example.com'};
var {'id': _, 'name': userName} = userInfo; // 忽略id字段，仅取name

• 丢弃函数返回值：

// 不需要异步操作的返回结果，直接丢弃
_ = fetchRemoteConfig();

// 遍历时忽略索引
var items = ['apple', 'banana'];
items.asMap().forEach((_, item) => print(item)); // 仅打印元素，忽略索引

3. 回调中的占位参数 #

当回调函数要求必须接收参数，但你不需要使用该参数时，可以用下划线作为占位符，让代码更简洁。

示例：

GestureDetector(
  // onLongPressStart要求接收LongPressStartDetails参数，但我们不需要使用它
  onLongPressStart: (_) => _showContextMenu(),
  child: const Text('长按操作'),
)

4. 测试代码中的约定用法 #

在测试文件中，下划线开头的标识符通常作为测试内部的辅助方法/变量，这是社区约定而非语法强制，用于区分测试逻辑和被测试代码。

内容的提问来源于stack exchange，提问作者Betty Wilson