能否在Flutter的FirebaseAuth.instance.currentUser中存储用户名？

首先明确：无法直接修改FirebaseAuth提供的User类（即FirebaseAuth.instance.currentUser的类型）来添加自定义字段，因为这是SDK封装的不可变类，没有开放自定义扩展的接口。不过可以通过以下几种方案实现你的需求：

方案1：利用User类自带的displayName字段 #

Firebase Auth的User类本身提供了displayName属性，可以把用户名存入这个字段，后续无需调用Firestore就能直接获取：

• 注册/更新用户信息时，同步设置displayName：

// 注册示例
UserCredential credential = await FirebaseAuth.instance.createUserWithEmailAndPassword(
  email: userEmail,
  password: userPassword,
);
// 将用户名设置到Auth用户的displayName
await credential.user?.updateProfile(displayName: userName);
// 同时写入Firestore的Users集合
await FirebaseFirestore.instance.collection('Users').doc(credential.user!.uid).set({
  'email': userEmail,
  'userName': userName,
  'avatar': avatarUrl,
});

• 后续获取用户名直接调用：

String? userName = FirebaseAuth.instance.currentUser?.displayName;

注意：如果用户后续修改用户名，需要同时更新Firestore的userName字段和Auth的displayName，保证数据一致性。

方案2：全局状态管理（推荐） #

通过Flutter状态管理工具（如Provider、Riverpod、Bloc），在用户登录后一次性调用getUserDetails获取完整用户信息，并存入全局状态，后续所有组件直接从状态读取，无需重复请求Firestore：

• 以Riverpod为例，定义用户状态Provider：

final currentUserProvider = StateProvider<CloudUser?>((ref) => null);

• 登录成功后获取用户信息并更新状态：

Future<void> handleLogin(String email, String password) async {
  UserCredential credential = await FirebaseAuth.instance.signInWithEmailAndPassword(
    email: email,
    password: password,
  );
  // 获取用户详情
  CloudUser user = await getUserDetails(userId: credential.user!.uid);
  // 存入全局状态
  ref.read(currentUserProvider.notifier).state = user;
}

• 组件中直接读取用户名：

final user = ref.watch(currentUserProvider);
String userName = user?.userName ?? 'Guest';

方案3：本地缓存 #

使用SharedPreferences或Hive等本地存储工具，将用户信息缓存到设备本地，登录后优先读取缓存，缓存不存在或过期时再请求Firestore更新：

// 缓存用户信息
Future<void> cacheUser(CloudUser user) async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  await prefs.setString('userName', user.userName);
  // 可同时缓存其他字段
}

// 获取缓存的用户名
Future<String?> getCachedUserName() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  return prefs.getString('userName');
}

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