本文详解在 Fragment 中实现软键盘弹出时自动调整界面布局的方法，重点解决因 Activity 根布局高度约束不当（如 0dp + ConstraintLayout 链式约束）导致 Fragment 内容无法随键盘收缩/展开而响应的问题。
本文详解在 fragment 中实现软键盘弹出时自动调整界面布局的方法，重点解决因 activity 根布局高度约束不当（如 `0dp` + `constraintlayout` 链式约束）导致 fragment 内容无法随键盘收缩/展开而响应的问题。
在 Android 开发中，Fragment 本身不直接参与窗口软键盘（Soft Input）行为的生命周期管理——真正起决定性作用的是其宿主 Activity 的 windowSoftInputMode 设置与根 ViewGroup 的尺寸行为。常见误区是：开发者在 Fragment 布局中添加 android:fitsSystemWindows="true" 或尝试监听 ViewTreeObserver，却忽略了 Activity 层级的布局约束才是软键盘适配的关键前提。
✅ 正确做法：修复 Activity 根布局的高度约束
你提供的 main activity.xml 中存在一个典型问题：
<framelayout android:id="@+id/frame_full" android:layout_width="match_parent" android:layout_height="0dp" bottom android:layout_alignparenttop="true" android:layout_alignparentbottom="true"></framelayout>
⚠️ 注意：android:layout_alignParentTop 和 android:layout_alignParentBottom 是 RelativeLayout 的属性，但在 ConstraintLayout 中完全无效；同时 android:layout_height="0dp"（即 MATCH_CONSTRAINT）必须配合上下方向的约束（如 app:layout_constraintTop_toTopOf 和 app:layout_constraintBottom_toBottomOf），否则系统无法计算实际高度，导致 Fragment 容器无法响应键盘弹出时的窗口尺寸变化。
✅ 正确写法（已修正）如下：
<?xml version="1.0" encoding="utf-8"?><androidx.constraintlayout.widget.constraintlayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:app="http://schemas.android.com/apk/res-auto" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" tools:context=".BillActivity"><framelayout android:id="@+id/frame_full" android:layout_width="match_parent" android:layout_height="0dp" app:layout_constrainttop_totopof="parent" app:layout_constraintbottom_tobottomof="parent" app:layout_constraintstart_tostartof="parent" app:layout_constraintend_toendof="parent"></framelayout></androidx.constraintlayout.widget.constraintlayout>
? 关键点：
android:layout_height="0dp"必须搭配app:layout_constraintTop_toTopOf和app:layout_constraintBottom_toBottomOf，才能让FrameLayout占满可用高度，并在软键盘显示/隐藏时动态重绘。
✅ 补充必要配置（不可省略）
- 在
AndroidManifest.xml中为对应 Activity 设置软键盘模式：
<activity android:name=".BillActivity" android:windowsoftinputmode="adjustResize|stateHidden"></activity>
-
adjustResize：强制 Activity 视图随键盘收缩而重新布局（需配合可伸缩根布局）； -
stateHidden：默认隐藏软键盘（可选）。
-
确保 Fragment 布局支持弹性收缩（推荐使用
ScrollView或NestedScrollView包裹内容）：
你的 Fragment XML 当前是RelativeLayout+LinearLayout，虽可工作，但若输入框被键盘遮挡，建议将外层LinearLayout替换为NestedScrollView（尤其当内容可能超出一屏时）：
<nestedscrollview android:layout_width="match_parent" android:layout_height="match_parent" android:fillviewport="true"><linearlayout android:layout_width="match_parent" android:layout_height="wrap_content" android:orientation="vertical"><!-- EditText, Chip, etc. --></linearlayout></nestedscrollview>
? 提示：
android:fillViewport="true"确保 ScrollView 在内容不足时仍撑满父容器，避免空白区域。
⚠️ 注意事项与常见陷阱
- ❌ 不要在 Fragment 中单独设置
android:windowSoftInputMode—— 该属性仅对Activity有效； - ❌ 避免在
ConstraintLayout中混用RelativeLayout的layout_align*属性，会导致约束失效； - ❌
android:layout_height="wrap_content"在FrameLayout中可能导致键盘弹出后内容被截断（因不触发 resize）； - ✅ 推荐统一使用
android:fitsSystemWindows="true"（设在根布局）并配合adjustResize，提升沉浸式体验兼容性； - ✅ 调试技巧：在
onCreate()中打印getWindow().getAttributes().softInputMode，确认 manifest 配置已生效。
通过以上三步（修正 ConstraintLayout 约束、配置 adjustResize、包裹可滚动容器），即可让 Fragment 内容在软键盘弹出/收起时自然上推或恢复，彻底解决“Activity 有效、Fragment 无效”的适配难题。
