3. 回退栈机制：popBackStack、popBackStackImmediate、addToBackStack、回退栈监听

3.1 原理概述

Fragment回退栈（BackStack）是 FragmentManager 按事务顺序保存已提交 Fragment 切换记录的内部栈结构。每次通过 FragmentTransaction 执行 add()、replace()、remove() 等操作后调用 addToBackStack(null)，该事务就会被压入回退栈；当用户按下系统返回键或代码调用 popBackStack() 时，栈顶事务被逆序回滚，恢复上一个 Fragment 状态。

回退栈机制为 Fragment 导航提供了“可撤销”的天然支持，是构建向导、多层级页面、Tab 切换等场景的核心基础设施。理解 addToBackStack、popBackStack、popBackStackImmediate 以及回退栈监听器的差异与适用场景，是避免状态丢失和导航错乱的先决条件。

3.2 核心 API 对比

3.3 实现流程

1. 压入事务：在 FragmentTransaction 提交前调用 addToBackStack(null)（可传入名称，用于后续按名称弹出）。
2. 提交事务：commit()（异步）或 commitNow()（同步，但必须搭配 addToBackStack 使用）。
3. 回退栈增长：事务被 FragmentManager 内部记录，栈深度 +1。
4. 触发弹出：用户按返回键、代码调用 popBackStack() 或 popBackStackImmediate()。
5. 执行回滚：系统反向执行事务中的操作（如 remove 改为 add，replace 恢复原 Fragment），并销毁栈顶事务。
6. 监听回调：注册的 OnBackStackChangedListener 被触发，可在此处更新返回按钮可见性、标题等。

3.4 核心代码实现

// 1. 压入回退栈
getSupportFragmentManager().beginTransaction()
    .replace(R.id.fragment_container, new DetailsFragment())
    .addToBackStack("details")  // 传入名称，方便按名称弹出
    .commit();

// 2. 异步弹出（一般用于返回键）
getSupportFragmentManager().popBackStack();

// 3. 同步弹出，并立即获取结果
boolean popped = getSupportFragmentManager().popBackStackImmediate();
if (popped) {
    // 回退栈已弹出，可以安全操作当前 Fragment
} else {
    // 回退栈为空，可能是最后一层
}

// 4. 按名称弹出（可指定是否包含该事务自身）
// 弹出到名称为"details"的事务，不包含"details"自身（保留它）
getSupportFragmentManager().popBackStack("details", 0);
// 弹出到名称为"details"的事务，包含"details"自身（即弹出它）
getSupportFragmentManager().popBackStack("details", FragmentManager.POP_BACK_STACK_INCLUSIVE);

// 5. 注册回退栈监听器
getSupportFragmentManager().addOnBackStackChangedListener(() -> {
    int count = getSupportFragmentManager().getBackStackEntryCount();
    // 更新 UI：如果 count > 0 则显示 Toolbar 返回箭头
    // 更新当前 Fragment 的标题等
});

3.5 调试与验证

• 打印回退栈数量：FragmentManager.getBackStackEntryCount() 返回当前栈深度，在断点或日志中观察。
• 枚举栈内事务名称：通过 getBackStackEntryAt(int index).getName() 获取每个事务的名称，检查压栈顺序是否符合预期。
• 启用 Fragment 日志：在 adb shell setprop log.tag.FragmentManager VERBOSE 后，可观察系统内部回退栈操作的日志输出。
• 验证弹出后状态：在 onBackStackChanged 回调中检查当前可见 Fragment 的 onResume/onHiddenChanged 是否被正确调用。

3.6 常见错误与避坑

3.7 性能与稳定性优化

• 优先使用异步 popBackStack()：除非必须立即知道结果（如在返回键处理中判断是否应退出 Activity），否则让系统批量处理回退，减少单帧内执行大量 Fragment 生命周期操作的卡顿。
• 避免过深的回退栈：超过 10 层后，弹出操作涉及多个 Fragment 的状态保存和恢复，可能引发 ANR。建议在关键路径上使用 popBackStack(name, 0) 跳转至中间层，而非逐层弹出。
• 合理使用 commitNow() 搭配 addToBackStack：commitNow() 会立即同步执行事务，但会延迟到主线程空闲；在需要严格顺序的场景中（如嵌套 Fragment 的初始化），可结合 executePendingTransactions() 确保回退栈状态同步。
• 监听器的生命周期管理：在 Activity.onDestroy() 或 Fragment.onDestroy() 中调用 removeOnBackStackChangedListener()，防止内存泄漏。