7、Intent 与 Flag：Intent.FLAG_ACTIVITY_* 系列标志位详解与实战
各位同学，今天我们来聊聊 Intent 的 Flag。说实话，这玩意儿在 Android 开发里，属于那种「天天用，但未必真懂」的知识点。我自己带团队时，经常看到有人把 Flag 当咒语一样乱加，结果 Activity 栈乱成一锅粥。嗯，今天我们就把它彻底讲透。
7.1 为什么需要 Flag？
先问个问题：你启动一个 Activity，系统怎么知道该把它放哪？
默认情况下，系统会把它压入当前任务栈的栈顶。但实际场景远没这么简单——比如你从通知栏点进来，希望直接跳到某个页面，而不是把一堆 Activity 重新创建一遍；又比如你希望某个 Activity 在整个系统里只有一个实例。这些需求，靠默认行为是搞不定的。
说白了，Flag 就是用来「干预」Activity 启动流程的开关。你告诉系统：这次启动，按我的规矩来。
核心思想：Flag 控制的是 Activity 的「存在方式」和「栈位置」。不是所有启动都需要 Flag，但复杂场景下，它是你的救命稻草。
7.2 常用 Flag 详解
Android 提供了几十个 Flag，但日常开发中常用的就那么几个。我按使用频率和场景，把它们分成三类。
7.2.1 栈管理类
| Flag | 作用 | 典型场景 |
|---|---|---|
| FLAG_ACTIVITY_NEW_TASK | 在新任务栈中启动 Activity | 从 Service、BroadcastReceiver 启动 Activity |
| FLAG_ACTIVITY_CLEAR_TOP | 如果目标 Activity 已在栈中，清除它之上的所有 Activity | 从通知栏回到主界面 |
| FLAG_ACTIVITY_SINGLE_TOP | 如果目标 Activity 已在栈顶，不创建新实例 | 避免重复打开同一个页面 |
| FLAG_ACTIVITY_CLEAR_TASK | 启动前清除目标 Activity 所在的任务栈 | 强制重新开始一个任务 |
我个人习惯，FLAG_ACTIVITY_NEW_TASK 和 FLAG_ACTIVITY_CLEAR_TOP 经常搭配使用。比如从通知栏点击跳转：
Intent intent = new Intent(context, MainActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
context.startActivity(intent);这样做的效果是：如果 MainActivity 已经在某个任务栈中，就把它上面的页面全部干掉，然后复用这个实例。用户感觉就像「回到了主界面」，而不是重新打开了一个。
小技巧：FLAG_ACTIVITY_CLEAR_TOP 配合 FLAG_ACTIVITY_SINGLE_TOP 一起用，可以避免目标 Activity 被销毁重建。系统会直接调用它的 onNewIntent() 方法。
7.2.2 启动模式类
| Flag | 作用 | 与 launchMode 的关系 |
|---|---|---|
| FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY | 从历史记录中启动 | 系统自动添加，开发者一般不用 |
| FLAG_ACTIVITY_MULTIPLE_TASK | 允许创建多个任务栈实例 | 与 singleTask 配合使用 |
| FLAG_ACTIVITY_NO_USER_ACTION | 启动时取消用户动作回调 | 避免 onUserLeaveHint 被触发 |
这里有个坑，我曾经踩过。有一次做支付页面，用户支付成功后跳转到结果页。结果因为没加 FLAG_ACTIVITY_NO_USER_ACTION，用户按 Home 键时，系统误以为用户主动离开，触发了 onUserLeaveHint，导致支付状态被重置。嗯，从那以后，凡是后台启动的 Activity，我都会加上这个 Flag。
7.2.3 视觉与行为类
| Flag | 作用 | 注意事项 |
|---|---|---|
| FLAG_ACTIVITY_NO_ANIMATION | 启动时不播放动画 | 配合 overridePendingTransition 使用 |
| FLAG_ACTIVITY_REORDER_TO_FRONT | 把已有的 Activity 移到栈顶 | 不会清除栈内其他页面 |
| FLAG_ACTIVITY_FORWARD_RESULT | 把结果传递给下一个 Activity | 慎用，容易造成逻辑混乱 |
你想想看，FLAG_ACTIVITY_REORDER_TO_FRONT 和 FLAG_ACTIVITY_CLEAR_TOP 有什么区别？前者只是把目标 Activity 挪到栈顶，它上面的页面还在；后者是直接干掉上面的页面。我建议，如果你只是想「把某个页面提到前台」，用 REORDER_TO_FRONT；如果你想「回到某个页面并清空历史」，用 CLEAR_TOP。
7.3 实战：从通知栏启动的正确姿势
这是面试高频题，也是项目里最容易出 Bug 的地方。我们来看一个完整的例子。
场景：App 在后台，用户点击通知栏，希望回到之前浏览的页面，而不是重新启动。
// 构建通知
Intent intent = new Intent(context, TargetActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
// 如果 TargetActivity 已经在栈顶，复用并传递新数据
intent.addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);
PendingIntent pendingIntent = PendingIntent.getActivity(
context,
requestCode,
intent,
PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE
);这里有几个关键点：
- FLAG_IMMUTABLE：Android 12 开始，PendingIntent 必须声明可变性。我建议一律用 IMMUTABLE，除非你确实需要外部修改 Intent。
- FLAG_UPDATE_CURRENT：如果 PendingIntent 已存在，更新它的 Intent 数据。这样第二次点击通知时，可以携带新的参数。
- requestCode：不同的通知使用不同的 requestCode，否则 PendingIntent 会被复用。
注意：不要滥用 FLAG_ACTIVITY_NEW_TASK。如果你在 Activity 中启动另一个 Activity，默认就在同一个任务栈里，不需要加这个 Flag。只有在非 Activity 上下文（如 Service、BroadcastReceiver）中启动时，才必须加。
7.4 Flag 组合拳：常见模式
我总结了几个工作中最常用的 Flag 组合，你可以直接拿去用。
模式一：回到首页并清空栈
Intent intent = new Intent(context, HomeActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK);
startActivity(intent);这个组合会先清除整个任务栈，再创建 HomeActivity。效果相当于「重新打开 App」。
模式二：跳转到某个页面，保留返回栈
Intent intent = new Intent(context, DetailActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_REORDER_TO_FRONT);
startActivity(intent);如果 DetailActivity 已经在栈中，直接把它提到前台，用户按返回键还能回到之前的页面。
模式三：启动一个独立的 Activity
Intent intent = new Intent(context, PlayerActivity.class);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_LAUNCH_ADJACENT);
startActivity(intent);这个在分屏或多窗口模式下很有用。新 Activity 会在相邻窗口启动，而不是覆盖当前窗口。
7.5 知识体系图
下面这张图，是我梳理的 Flag 分类与使用场景。你可以把它当作速查表。
7.6 避坑指南
最后，分享几个我踩过的坑，希望能帮你省点时间。
- Flag 叠加顺序不重要：
intent.setFlags(A | B)和intent.setFlags(B | A)效果一样。但注意，多次调用 setFlags 会覆盖之前的设置，要用 addFlags 追加。 - FLAG_ACTIVITY_NEW_TASK 不是万能的：在 Android 10 以后，系统对后台启动 Activity 做了严格限制。即使加了 NEW_TASK，也可能被系统拦截。建议改用通知或全屏 Intent。
- 不要和 launchMode 混用：如果你在 Manifest 里给 Activity 设置了 singleTask，又在代码里加 FLAG_ACTIVITY_NEW_TASK，系统会以代码中的 Flag 为准。我建议统一用一种方式，避免混乱。
- FLAG_ACTIVITY_CLEAR_TOP 的副作用：它会调用目标 Activity 的 onNewIntent()，但不会调用 onCreate()。如果你在 onCreate() 里做了初始化，记得在 onNewIntent() 里也做一遍。
我的习惯：在团队里，我要求所有涉及 Flag 的代码，必须写注释说明「为什么用这个 Flag」。三个月后回头看，没人记得当初为什么这么写。注释就是写给未来的自己看的。
好了，关于 Intent Flag 的内容就到这里。记住，Flag 是工具，不是目的。理解每个 Flag 背后的栈行为，比死记硬背组合更重要。下次遇到奇怪的启动问题，先画个栈图，再想用什么 Flag，思路会清晰很多。