重构Flutter应用：跨全局变量管理的最优方案咨询

针对你提到的旧Flutter应用用全局变量管理权限、用户ID等数据的问题，以下是几种比全局变量更可控、易维护的成熟替代方案，按推荐优先级排序：

一、服务类（优先推荐） #

将分散的全局数据封装到单一职责的服务类中，是替代全局变量最直接的方案，能避免全局变量的混乱和误修改。

1. 单例服务类 #

把权限、用户ID这类核心数据封装到单例服务里，通过私有属性+公开方法控制数据的读写：

class AuthService {
  // 单例实现
  static final AuthService _instance = AuthService._internal();
  factory AuthService() => _instance;
  AuthService._internal();

  // 私有存储，避免直接修改
  String? _userId;
  int? _permissionLevel;

  // 只读获取方法
  String? get userId => _userId;
  int? get permissionLevel => _permissionLevel;

  // 受控更新方法
  void updateAuthData(String userId, int permissionLevel) {
    _userId = userId;
    _permissionLevel = permissionLevel;
  }

  // 清空数据（如退出登录）
  void clearAuthData() {
    _userId = null;
    _permissionLevel = null;
  }
}

使用示例：

// 登录成功后更新数据
AuthService().updateAuthData('user_123', 2);
// 任意页面获取数据
final currentUserId = AuthService().userId;

2. 依赖注入（DI）管理服务 #

如果项目规模较大，用依赖注入（比如get_it）管理服务，能提升代码的可测试性和模块解耦度：
先注册服务：

import 'package:get_it/get_it.dart';

final getIt = GetIt.instance;

void setupServices() {
  getIt.registerSingleton<AuthService>(AuthService());
}

在main函数初始化：

void main() async {
  setupServices();
  runApp(const MyApp());
}

使用时通过DI获取实例：

final authService = getIt<AuthService>();
authService.updateAuthData('user_456', 1);

二、结合状态管理实现响应式数据 #

如果数据变化需要同步更新UI（比如权限变化后页面自动切换），可以将服务类与状态管理工具结合：

• Provider/ChangeNotifier：适合中小型项目，简单易集成
• Riverpod：无需上下文即可访问状态，代码更简洁
• Bloc/Cubit：适合复杂业务逻辑，实现数据与UI的完全分离

示例（ChangeNotifier版）：

class AuthService extends ChangeNotifier {
  String? _userId;
  int? _permissionLevel;

  String? get userId => _userId;
  int? get permissionLevel => _permissionLevel;

  void updateAuthData(String userId, int permissionLevel) {
    _userId = userId;
    _permissionLevel = permissionLevel;
    // 通知UI更新
    notifyListeners();
  }
}

UI中监听数据变化：

Consumer<AuthService>(
  builder: (context, authService, child) {
    return Text('当前用户：${authService.userId ?? '未登录'}');
  },
)

三、本地存储持久化数据 #

如果需要跨应用启动保存数据（比如记住登录状态），可以在服务类中封装本地存储逻辑（用shared_preferences或hive）：

import 'package:shared_preferences/shared_preferences.dart';

class AuthService {
  static final AuthService _instance = AuthService._internal();
  factory AuthService() => _instance;
  AuthService._internal();

  String? _userId;
  int? _permissionLevel;
  late SharedPreferences _prefs;

  // 初始化时从本地加载数据
  Future<void> init() async {
    _prefs = await SharedPreferences.getInstance();
    _userId = _prefs.getString('userId');
    _permissionLevel = _prefs.getInt('permissionLevel');
  }

  void updateAuthData(String userId, int permissionLevel) {
    _userId = userId;
    _permissionLevel = permissionLevel;
    // 同步保存到本地
    _prefs.setString('userId', userId);
    _prefs.setInt('permissionLevel', permissionLevel);
  }

  void clearAuthData() {
    _userId = null;
    _permissionLevel = null;
    _prefs.remove('userId');
    _prefs.remove('permissionLevel');
  }
}

四、环境变量存储固定配置 #

如果是API地址、默认权限这类固定配置，推荐用环境变量（通过flutter_dotenv）管理，避免硬编码：
创建.env文件：

API_BASE_URL=https://api.yourdomain.com
DEFAULT_PERMISSION=0

使用时读取：

import 'package:flutter_dotenv/flutter_dotenv.dart';

final apiUrl = dotenv.env['API_BASE_URL'];

方案选择参考 #

• 小型项目：单例服务类，快速落地，无需额外依赖
• 中型项目：依赖注入+Provider/Riverpod，兼顾可维护性和响应式UI
• 大型项目：Bloc/Riverpod+本地存储+依赖注入，实现完全解耦和可测试性

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