Flutter 3.10.4：如何让含自动聚焦TextField的BottomSheet随键盘移动？

你当前的代码已开启isScrollControlled: true，但仍存在键盘遮挡问题，可通过以下调整解决：

关键修改点及完整代码示例 #

showModalBottomSheet(
  useSafeArea: true,
  isScrollControlled: true,
  backgroundColor: Colors.white, // 替换为你需要的背景色，透明背景需确保内部容器可见
  context: context,
  builder: (context) {
    return Consumer<OnBoardingProvider>(
      builder: (context, provider, child) {
        // 初始化焦点节点，确保BottomSheet构建后自动聚焦TextField
        final focusNode = FocusNode();
        WidgetsBinding.instance.addPostFrameCallback((_) {
          FocusScope.of(context).requestFocus(focusNode);
        });

        return Padding(
          // 应用完整的viewInsets，包含键盘弹出时的底部间距
          padding: MediaQuery.of(context).viewInsets,
          child: SingleChildScrollView(
            child: Container(
              padding: EdgeInsets.symmetric(horizontal: 16, vertical: 20),
              child: Column(
                // 让Column仅占用必要高度，避免BottomSheet过度拉伸
                mainAxisSize: MainAxisSize.min,
                children: [
                  TextField(
                    focusNode: focusNode,
                    autofocus: true, // 开启自动聚焦触发键盘弹出
                    decoration: InputDecoration(hintText: "请输入内容"),
                  ),
                  // 替换为你的<MyWidget>内容
                ],
              ),
            ),
          ),
        );
      },
    );
  },
);

核心调整说明 #

• 正确应用视图内边距：直接使用MediaQuery.of(context).viewInsets作为外层Padding，它会自动获取键盘弹出时的底部偏移量，带动整个BottomSheet上移。
• 确保TextField自动聚焦：通过autofocus: true结合FocusNode，在BottomSheet渲染完成后主动请求焦点，保证键盘同步弹出且BottomSheet跟随移动。
• 控制布局高度：给内部Column设置mainAxisSize: MainAxisSize.min，避免BottomSheet占据过多屏幕高度，影响适配效果。
• 背景色设置：若使用透明背景，需给内部Container添加可见背景色，否则内容会和底层页面重叠，影响交互体验。

额外排查点 #

• 检查你的<MyWidget>内部是否存在固定高度的布局组件，这类组件可能导致BottomSheet无法灵活调整高度。
• 避免嵌套多层滚动组件（如NestedScrollView），否则可能出现布局冲突，导致键盘适配失效。

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