如何无需逐个页面修改，全局统一替换Flutter应用的返回按钮图标

目前Flutter官方提供的AppBarTheme确实未开放全局配置默认返回按钮图标的参数，你可以通过以下两种主流方案实现全局替换，无需逐个页面调整：

方案1：封装自定义全局AppBar组件（最推荐，灵活性最高） #

自定义统一的AppBar组件，所有页面直接复用该组件即可，还可以同步管理其他AppBar全局配置，适配性最高：

class CustomAppBar extends PreferredSizeWidget {
  final Widget? title;
  final List<Widget>? actions;
  // 可根据需求添加其他需要透传的AppBar参数

  const CustomAppBar({super.key, this.title, this.actions});

  @override
  Widget build(BuildContext context) {
    return AppBar(
      elevation: 0,
      systemOverlayStyle: SystemUiOverlayStyle(statusBarBrightness: Brightness.light),
      titleTextStyle: Theme.of(context).textTheme.headline6,
      backgroundColor: Colors.transparent,
      iconTheme: IconThemeData(color: dark3),
      // 全局统一配置返回按钮
      leading: Navigator.canPop(context) ? IconButton(
        icon: const Icon(Icons.arrow_back_ios), // 替换为你需要的自定义图标
        onPressed: () => Navigator.maybePop(context),
      ) : null,
      title: title,
      actions: actions,
      // 其他透传的AppBar参数
    );
  }

  @override
  Size get preferredSize => const Size.fromHeight(kToolbarHeight);
}

后续所有页面的AppBar都替换为CustomAppBar即可，也可以随时扩展其他全局配置逻辑。

方案2：通过MaterialApp的builder属性全局拦截替换 #

如果是老项目不想改动现有页面的AppBar引用，可以用builder属性全局拦截修改所有AppBar的返回按钮：

MaterialApp(
  theme: ThemeData(
    // 保留你原来的AppBarTheme配置
    appBarTheme: AppBarTheme(
      elevation: 0,
      systemOverlayStyle: SystemUiOverlayStyle(statusBarBrightness: Brightness.light),
      titleTextStyle: Theme.of(context).textTheme.headline6,
      color: Colors.transparent,
      iconTheme: IconThemeData(color: dark3)
    ),
  ),
  builder: (context, child) {
    return Builder(
      builder: (context) {
        // 匹配当前页面的Scaffold和AppBar
        if (child is Scaffold && child.appBar is AppBar) {
          final originalAppBar = child.appBar as AppBar;
          // 页面已经单独配置leading的不做覆盖，只替换默认的返回按钮
          if (originalAppBar.leading != null) return child;
          
          return Scaffold(
            appBar: AppBar(
              key: originalAppBar.key,
              title: originalAppBar.title,
              actions: originalAppBar.actions,
              elevation: originalAppBar.elevation,
              backgroundColor: originalAppBar.backgroundColor,
              iconTheme: originalAppBar.iconTheme,
              // 替换为自定义返回按钮
              leading: Navigator.canPop(context) ? IconButton(
                icon: const Icon(Icons.arrow_back_ios),
                onPressed: () => Navigator.maybePop(context),
              ) : null,
              // 其余原AppBar属性全部透传即可
            ),
            body: child.body,
            // 其余原Scaffold属性全部透传即可
          );
        }
        return child!;
      },
    );
  },
  // 其他MaterialApp配置
);

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