Dy's Notes

Appearance

Dart语言入门 - 函数与作用域详解（新手避坑手册） ​

⚠️ 注意：Dart 函数的参数机制与其他语言差异巨大！本文大量标注了[参数顺序陷阱][空安全参数问题]等高发错误点

目录 ​

  1. 函数基础定义
  2. 参数类型与陷阱
  3. 作用域深层剖析
  4. 高阶函数与闭包
  5. 特殊函数形式
  6. 常见错误排查

1. 函数基础定义 ​

必会的两种形式 ​

dart
// 标准形式（显式声明返回类型）
int add(int a, int b) {
  return a + b;
}

// 箭头函数（单表达式简写）
double calcArea(double r) => 3.14 * r * r;

⚠️ 箭头函数使用限制：

  • 只能包含单个表达式，不能包含控制流语句（如if/for）
  • 不适合复杂的逻辑处理，易导致调试困难

函数的"一等公民"特性 ​

dart
// 1. 作为变量赋值
Function greet = (String name) => 'Hello, $name';

// 2. 作为参数传递
void runCallback(void callback()) {
  callback();
}

2. 参数类型与陷阱 ​

必须参数 vs 可选参数 ​

dart
// 1. 必需参数（位置参数）：调用时必须按顺序传参
void login(String username, String password) { ... }

// 2. 可选参数形式：
// 2.1 可选命名参数（用花括号包裹，需要指定参数名）
void config({bool isDebug, int retryCount = 3}) {
  // 默认值必须为编译时常量
}

// 2.2 可选位置参数（用方括号包裹，按顺序传参）
void download(String url, [String? path, int timeout = 30]) { ... }

🚨 新手致命误区：

  1. 是否可选参数必须放在参数列表最后

    dart
    // ❌ 错误示范
void errorFunc([int a], int b) { ... } 
// ✅ 正确形式
void correctFunc(int b, [int a]) { ... }

  2. 命名参数和位置参数不能混用

    dart
    void foo(int x, {int y}) { ... }

// ❌ 错误调用
foo(1, 5);   // 5不明确是命名参数还是位置参数
// ✅ 正确调用
foo(1, y:5);

空安全参数规范 ​

dart
// 可选命名参数默认不可空 → 必须提供默认值或者标记为可空
void danger({int value}) { ... } 
     ↓ ↓ ↓ 正确解决办法 ↓ ↓ ↓ 
void safe1({int? value}) { ... }       // 允许null
void safe2({int value = 0}) { ... }    // 默认值保障非空

3. 作用域深层剖析 ​

词法作用域规则 ​

dart
bool isReady = true;

void main() {
  var message = 'Hello';
  
  if (isReady) {
    var innerMsg = 'World';
    print(message);   // 可以访问外层变量
  }
  
  print(innerMsg);    // ❌ 访问内部块级作用域变量 → 报错！
}

变量覆盖警告 ​

dart
var name = 'Global';

void test() {
  var name = 'Local';  // 覆盖全局变量 → 无报错但可能产生隐患
  print(name);         // 输出 Local
}

4. 高阶函数与闭包 ​

函数作为返回值 ​

dart
Function makeMultiplier(num factor) {
  return (num value) => value * factor; // 捕获外部factor变量
}

void main() {
  var triple = makeMultiplier(3);
  print(triple(5));  // 15 → 闭包保持了factor的状态
}

闭包的延迟求值陷阱 ​

dart
List<Function> funcs = [];
for (var i = 0; i < 3; i++) {
  funcs.add(() => print(i));
}

funcs.forEach((f) => f()); 
// 输出: 3 → 3 → 3 （因为闭包捕获的是i的引用）
// 正确方法：在循环内创建局部变量保存当前值

5. 特殊函数形式 ​

匿名函数（Lambda） ​

dart
// 两种等效写法（注意参数类型的可声明性）
list.map((item) => item.toUpperCase());
list.map((String item) { return item.toUpperCase(); });

Getter/Setter 方法 ​

dart
class User {
  String _name = '';
  
  String get name => _name.toUpperCase();  // 转换成大写输出
  set name(String value) => _name = value.trim();
}

泛型函数 ​

dart
// T 推断自传入参数类型
T firstElement<T>(List<T> list) => list.first;

var num = firstElement([1,2,3]);     // 自动推断T为int
var str = firstElement(['a','b']);   // 自动推断T为String

6. 常见错误排查 ​

错误1：参数顺序错误 ​

dart
void printInfo(String name, [int age = 0, String? email]){...}

printInfo('Alice', 'alice@test.com');  
// ❌ 'alice@test.com'被误传给age参数 → 类型不匹配报错

错误2：忽略函数返回类型推断 ​

dart
// 推断返回类型为dynamic → 存在隐患
parseData(data) { ... }
    ↓ ↓ ↓ 正确写法 ↓ ↓ ↓ 
Map<String, dynamic> parseData(String data) { ... }

错误3：误用动态类型 ​

dart
void execute(Function operation) { operation(); }

execute(print('Test')); // ❌ 传入的是null（表达式结果）!
       ↓ ↓ ↓ 应当传入函数对象 ↓ ↓ ↓ 
execute(() => print('Test'));

✅ 总结精华：

  1. 理解三种参数类型（必填、可选命名、可选位置）的关系与顺序约束
  2. 所有函数的前导参数必须相同类型（不混合命名和位置参数）
  3. 闭包捕获是变量引用而非值的快照
  4. 坚持声明函数返回类型以提升代码安全性
  5. 对可能为空的参数必须显式处理（使用默认值或可空类型）

💡 性能提示：

  • 避免在频繁调用的函数中创建闭包（可能引发内存问题）
  • 简单操作优先使用箭头函数，复杂逻辑使用标准函数体

🚀 进阶思考题：

  1. 如何实现一个允许同时接收位置命名参数的函数？
  2. 当高阶函数返回另一个函数时，如何避免内存泄漏？
  3. 为什么 var list = List.generate(3, (i) => () => print(i)) 能正确输出0,1,2？

（参考答案可通过注释或私信获得）