diff --git a/docs/vue/composition-api.md b/docs/vue/composition-api.md
index ddf6a837b228adb3a763e1080e1cf668dccfd99b..bd35d5227082e819f62ecee0458aedd9ede89282 100644
--- a/docs/vue/composition-api.md
+++ b/docs/vue/composition-api.md
@@ -417,6 +417,16 @@
 如果需要获取排版后的节点信息推荐使用 [uni.createSelectorQuery](../api/nodes-info.md) 不推荐直接使用 [Element](../dom/unielement.md) 对象。\
 在修改 DOM 后，立刻使用 [Element](../dom/unielement.md) 对象的同步接口获取 DOM 状态可能获取到的是排版之前的，而 [uni.createSelectorQuery](../api/nodes-info.md) 可以保障获取到的节点信息是排版之后的。
 
+#### onActivated、onDeactivated 使用注意事项 @activated-deactivated-tips
+
+当 A 页面存在 `keepAlive` 组件，A 页面 `navigateTo` B 页面时
+- Web 端 A 页面中 `keepAlive` 的组件会触发 `onDeactivated` 生命周期
+- App 端 A 页面中 `keepAlive` 的组件不会触发 `onDeactivated` 生命周期
+
+当 B 页面 back 返回 A 页面时
+- Web 端 A 页面中 `keepAlive` 的组件会触发 `onActivated` 生命周期
+- App 端 A 页面中 `keepAlive` 的组件不会触发 `onActivated` 生命周期
+
 示例 [详情](<!-- VUEJSON.E_lifecycle.component_ChildComponentComposition.gitUrl -->)
 
 ::: preview <!-- VUEJSON.E_lifecycle.component_ChildComponentComposition.webUrl -->
diff --git a/docs/vue/options-api.md b/docs/vue/options-api.md
index 6423b0ac5e7957f7bbf195c57356a09554d5a5fd..b77c90ef8b4ebd1236988114b29beb198285dfa8 100644
--- a/docs/vue/options-api.md
+++ b/docs/vue/options-api.md
@@ -151,6 +151,16 @@
 如果需要获取排版后的节点信息推荐使用 [uni.createSelectorQuery](../api/nodes-info.md) 不推荐直接使用 [Element](../dom/unielement.md) 对象。\
 在修改 DOM 后，立刻使用 [Element](../dom/unielement.md) 对象的同步接口获取 DOM 状态可能获取到的是排版之前的，而 [uni.createSelectorQuery](../api/nodes-info.md) 可以保障获取到的节点信息是排版之后的。
 
+#### activated、deactivated 使用注意事项 @activated-deactivated-tips
+
+当 A 页面存在 `keepAlive` 组件，A 页面 `navigateTo` B 页面时
+- Web 端 A 页面中 `keepAlive` 的组件会触发 `deactivated` 生命周期
+- App 端 A 页面中 `keepAlive` 的组件不会触发 `deactivated` 生命周期
+
+当 B 页面 back 返回 A 页面时
+- Web 端 A 页面中 `keepAlive` 的组件会触发 `activated` 生命周期
+- App 端 A 页面中 `keepAlive` 的组件不会触发 `activated` 生命周期
+
 示例 [详情](<!-- VUEJSON.E_lifecycle.component_ChildComponentOptions.gitUrl -->)
 
 ::: preview <!-- VUEJSON.E_lifecycle.component_ChildComponentOptions.webUrl -->