Flutter开发中已声明final变量却提示未定义的解决思路

你遇到的username未定义报错，本质是Dart的块级作用域规则：

• 你误以为username是在整个函数的逻辑上方完成的声明，实际上这个变量是在if (!doc.exists)的大括号代码块内部用final声明的，它的有效访问范围仅覆盖这个if块包裹的代码段。
• 当代码执行到if块外部的usersRef.doc(user.id).set()逻辑时，已经完全超出了username的有效作用域，编译器自然会提示变量未定义。
  哪怕你把变量类型调整为String，只要声明位置还在if块内部，这个作用域问题不会有任何改变，和变量类型完全无关。

你需要把username的声明位置提到if块的外部，让它的作用域覆盖整个函数的后续逻辑，可参考以下调整后的完整代码：

createUser() async {
  // 检查数据库中是否已有对应用户
  GoogleSignInAccount user = googleSignIn.currentUser;
  final doc = await usersRef.doc(user.id).get();
  // 提前在if块外声明username，作用域覆盖整个函数后续逻辑
  String? username;

  // 如果用户不存在则跳转至账号创建页
  if (!doc.exists) {
    // 仅在if块内部完成赋值，不再重复声明新的局部变量
    username = await Navigator.push(
      context, 
      MaterialPageRoute(builder: (context) => const CreateAccount())
    );
  }

  // 此处已可正常访问到username变量
  usersRef.doc(user.id).set({
    "id": user.id,
    "userName": username,
    "photourl": user.photoUrl,
    "displayName": user.displayName,
    "timeStamp": timestamp,
  });
}

逻辑补全提示 #

如果当doc.exists为true、也就是用户已经存在的场景，需要同步给username赋值，避免数据库写入空值：

// 在上述if判断后补充分支赋值逻辑
if (!doc.exists) {
  username = await Navigator.push(...);
} else {
  // 已存在的用户直接从已有文档快照中读取已存储的用户名
  username = doc.data()?['userName'] as String?;
}

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