<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>JavaScript on 吾爱主机</title><link>https://blog.waihost.com/categories/javascript/</link><description>Recent content in JavaScript on 吾爱主机</description><generator>Hugo -- gohugo.io</generator><language>zh-cn</language><lastBuildDate>Sun, 26 Jul 2026 00:00:00 +0800</lastBuildDate><atom:link href="https://blog.waihost.com/categories/javascript/index.xml" rel="self" type="application/rss+xml"/><item><title>Vue 3 响应式系统：Proxy、依赖收集与 effect 调度工程实践</title><link>https://blog.waihost.com/posts/vue3-reactivity-proxy-effect-scheduling/</link><pubDate>Sun, 26 Jul 2026 00:00:00 +0800</pubDate><guid>https://blog.waihost.com/posts/vue3-reactivity-proxy-effect-scheduling/</guid><description>&lt;img src="https://blog.waihost.com/images/covers/vue3-reactivity-proxy-effect-scheduling.svg" alt="Featured image of post Vue 3 响应式系统：Proxy、依赖收集与 effect 调度工程实践" /&gt;&lt;p&gt;改了数据视图却不更新、解构后“丢响应”、深度监听里 &lt;code&gt;newValue === oldValue&lt;/code&gt;、异步里创建的 &lt;code&gt;watch&lt;/code&gt; 内存泄漏——这些坑多半不是“Vue 坏了”，而是 &lt;strong&gt;依赖收集（track）与派发更新（trigger）&lt;/strong&gt; 的契约被绕开了。本文基于 Vue 官方 &lt;em&gt;Reactivity in Depth&lt;/em&gt;、&lt;em&gt;Reactivity Fundamentals&lt;/em&gt;、&lt;em&gt;Watchers&lt;/em&gt; 与 &lt;em&gt;Reactivity API&lt;/em&gt; 文档，并结合 MDN 的 &lt;code&gt;Proxy&lt;/code&gt; 说明，把 Vue 3 响应式从原理讲到可复现的工程实践。&lt;/p&gt;
&lt;h2 id="问题背景为什么改了变量-ui-不跟着变"&gt;&lt;a href="#%e9%97%ae%e9%a2%98%e8%83%8c%e6%99%af%e4%b8%ba%e4%bb%80%e4%b9%88%e6%94%b9%e4%ba%86%e5%8f%98%e9%87%8f-ui-%e4%b8%8d%e8%b7%9f%e7%9d%80%e5%8f%98" class="header-anchor"&gt;&lt;/a&gt;问题背景：为什么“改了变量 UI 不跟着变”
&lt;/h2&gt;&lt;p&gt;普通 JavaScript 赋值不会自动重算依赖值。官方用表格公式类比：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-js" data-lang="js"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;A0&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;A1&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;A2&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;A0&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;A1&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;A0&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;// A2 仍然是 3
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;要让 &lt;code&gt;A2&lt;/code&gt; 随依赖变化，需要三件事：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;读依赖时登记订阅&lt;/strong&gt;（track）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;写依赖时通知订阅者&lt;/strong&gt;（trigger）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;把“重算逻辑”包装成 effect&lt;/strong&gt;，在依赖变化时重跑&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Vue 做不到拦截局部变量读写（语言层面没有钩子），但能拦截 &lt;strong&gt;对象属性&lt;/strong&gt; 的读/写。Vue 2 主要靠 &lt;code&gt;Object.defineProperty&lt;/code&gt; 的 getter/setter；Vue 3 对 &lt;strong&gt;响应式对象使用 &lt;code&gt;Proxy&lt;/code&gt;&lt;/strong&gt;，对 &lt;strong&gt;ref 使用 getter/setter&lt;/strong&gt;。MDN 指出 &lt;code&gt;Proxy&lt;/code&gt; 可自定义对象的基础操作（属性查找、赋值、枚举、函数调用等），这正是 Vue 运行时收集依赖的入口。&lt;/p&gt;
&lt;h2 id="核心原理track--trigger--effect"&gt;&lt;a href="#%e6%a0%b8%e5%bf%83%e5%8e%9f%e7%90%86track--trigger--effect" class="header-anchor"&gt;&lt;/a&gt;核心原理：track / trigger / effect
&lt;/h2&gt;&lt;h3 id="1-proxy-拦截对象属性"&gt;&lt;a href="#1-proxy-%e6%8b%a6%e6%88%aa%e5%af%b9%e8%b1%a1%e5%b1%9e%e6%80%a7" class="header-anchor"&gt;&lt;/a&gt;1. Proxy 拦截对象属性
&lt;/h3&gt;&lt;p&gt;官方伪代码把机制压缩得很清楚：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-js" data-lang="js"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nx"&gt;reactive&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;obj&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="k"&gt;new&lt;/span&gt; &lt;span class="nb"&gt;Proxy&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;obj&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;get&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;target&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;key&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;track&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;target&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;key&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;target&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;key&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;},&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;set&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;target&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;key&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;target&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;key&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;value&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;trigger&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;target&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;key&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;})&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nx"&gt;ref&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;refObject&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;get&lt;/span&gt; &lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;track&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;refObject&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;value&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;value&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;},&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;set&lt;/span&gt; &lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;newValue&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;value&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;newValue&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;trigger&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;refObject&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;value&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nx"&gt;refObject&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;含义：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;读路径&lt;/strong&gt;调用 &lt;code&gt;track&lt;/code&gt;：当前正在执行的 effect 订阅该属性。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;写路径&lt;/strong&gt;调用 &lt;code&gt;trigger&lt;/code&gt;：通知订阅该属性的 effect 重跑。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;ref&lt;/code&gt; 把任意类型装进带 &lt;code&gt;.value&lt;/code&gt; 的容器，用 getter/setter 完成同一套 track/trigger。&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id="2-依赖存储结构"&gt;&lt;a href="#2-%e4%be%9d%e8%b5%96%e5%ad%98%e5%82%a8%e7%bb%93%e6%9e%84" class="header-anchor"&gt;&lt;/a&gt;2. 依赖存储结构
&lt;/h3&gt;&lt;p&gt;effect 订阅存在全局结构（概念上）为：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-text" data-lang="text"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;WeakMap&amp;lt;target, Map&amp;lt;key, Set&amp;lt;effect&amp;gt;&amp;gt;&amp;gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;ul&gt;
&lt;li&gt;&lt;code&gt;target&lt;/code&gt;：原始对象（或 ref 对象）&lt;/li&gt;
&lt;li&gt;&lt;code&gt;key&lt;/code&gt;：属性名（ref 固定为 &lt;code&gt;'value'&lt;/code&gt;）&lt;/li&gt;
&lt;li&gt;&lt;code&gt;Set&amp;lt;effect&amp;gt;&lt;/code&gt;：依赖该属性的副作用集合&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;code&gt;track&lt;/code&gt; 时若存在 &lt;code&gt;activeEffect&lt;/code&gt;，把它加入对应 Set；&lt;code&gt;trigger&lt;/code&gt; 时遍历该 Set 并执行。&lt;code&gt;WeakMap&lt;/code&gt; 以对象为键，目标对象不再被引用时依赖图可被 GC，这是设计上的关键点。&lt;/p&gt;
&lt;h3 id="3-activeeffect-与-reactive-effect"&gt;&lt;a href="#3-activeeffect-%e4%b8%8e-reactive-effect" class="header-anchor"&gt;&lt;/a&gt;3. activeEffect 与 Reactive Effect
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-js" data-lang="js"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;activeEffect&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nx"&gt;whenDepsChange&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;update&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;effect&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="p"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;activeEffect&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;effect&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;update&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;activeEffect&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="kc"&gt;null&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;effect&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="c1"&gt;// 首次运行即可完成依赖收集
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;首次执行 effect 时，内部读到的响应式属性都会把“当前 effect”登记为订阅者；之后依赖变更再 &lt;code&gt;trigger&lt;/code&gt;。Vue 对外暴露的 &lt;strong&gt;&lt;code&gt;watchEffect()&lt;/code&gt;&lt;/strong&gt; 就是创建这种 &lt;strong&gt;Reactive Effect&lt;/strong&gt; 的 API：立即运行、自动收集依赖、依赖变化后重跑。组件渲染本身也是一个（更复杂的）reactive effect——状态与 DOM 同步的底层模型。&lt;/p&gt;
&lt;h3 id="4-computed-是带缓存的-effect"&gt;&lt;a href="#4-computed-%e6%98%af%e5%b8%a6%e7%bc%93%e5%ad%98%e7%9a%84-effect" class="header-anchor"&gt;&lt;/a&gt;4. computed 是带缓存的 effect
&lt;/h3&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-js" data-lang="js"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;ref&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;computed&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="nx"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;vue&amp;#39;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;A0&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;ref&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;A1&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;ref&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;A2&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;computed&lt;/span&gt;&lt;span class="p"&gt;(()&lt;/span&gt; &lt;span class="p"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;A0&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="nx"&gt;A1&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;computed&lt;/code&gt; 内部用 reactive effect 管理失效与重算：依赖不变时读缓存，依赖变更后标记脏并在下次读取时重算。适合 &lt;strong&gt;派生状态&lt;/strong&gt;；需要发请求、写 DOM 等 &lt;strong&gt;副作用&lt;/strong&gt; 时用 &lt;code&gt;watch&lt;/code&gt; / &lt;code&gt;watchEffect&lt;/code&gt;。&lt;/p&gt;
&lt;h2 id="api-选型refreactiveshallowreadonly"&gt;&lt;a href="#api-%e9%80%89%e5%9e%8brefreactiveshallowreadonly" class="header-anchor"&gt;&lt;/a&gt;API 选型：ref、reactive、shallow、readonly
&lt;/h2&gt;&lt;table&gt;
	&lt;thead&gt;
			&lt;tr&gt;
					&lt;th&gt;API&lt;/th&gt;
					&lt;th&gt;本质&lt;/th&gt;
					&lt;th&gt;默认深度&lt;/th&gt;
					&lt;th&gt;典型用途&lt;/th&gt;
			&lt;/tr&gt;
	&lt;/thead&gt;
	&lt;tbody&gt;
			&lt;tr&gt;
					&lt;td&gt;&lt;code&gt;ref(x)&lt;/code&gt;&lt;/td&gt;
					&lt;td&gt;&lt;code&gt;.value&lt;/code&gt; 容器；对象值会再走 &lt;code&gt;reactive&lt;/code&gt;&lt;/td&gt;
					&lt;td&gt;深&lt;/td&gt;
					&lt;td&gt;基本类型与统一写法的首选&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;&lt;code&gt;reactive(obj)&lt;/code&gt;&lt;/td&gt;
					&lt;td&gt;ES Proxy，&lt;strong&gt;≠&lt;/strong&gt; 原对象&lt;/td&gt;
					&lt;td&gt;深&lt;/td&gt;
					&lt;td&gt;对象/数组状态（注意解构与身份）&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;&lt;code&gt;shallowRef(x)&lt;/code&gt;&lt;/td&gt;
					&lt;td&gt;只跟踪 &lt;code&gt;.value&lt;/code&gt; 替换&lt;/td&gt;
					&lt;td&gt;浅&lt;/td&gt;
					&lt;td&gt;大对象、不可变快照、外部状态库&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;&lt;code&gt;shallowReactive(obj)&lt;/code&gt;&lt;/td&gt;
					&lt;td&gt;仅根属性响应式&lt;/td&gt;
					&lt;td&gt;浅&lt;/td&gt;
					&lt;td&gt;根级大表/性能边界（慎嵌套）&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;&lt;code&gt;readonly(x)&lt;/code&gt;&lt;/td&gt;
					&lt;td&gt;只读深代理，仍可被 track&lt;/td&gt;
					&lt;td&gt;深&lt;/td&gt;
					&lt;td&gt;对外暴露不可变视图&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;&lt;code&gt;toRaw&lt;/code&gt; / &lt;code&gt;markRaw&lt;/code&gt;&lt;/td&gt;
					&lt;td&gt;逃逸/标记永不代理&lt;/td&gt;
					&lt;td&gt;—&lt;/td&gt;
					&lt;td&gt;读原对象、第三方实例、性能 opt-out&lt;/td&gt;
			&lt;/tr&gt;
	&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;关键事实（官方 API 文档）：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;reactive()&lt;/code&gt; &lt;strong&gt;深转换&lt;/strong&gt;嵌套属性；嵌套 ref 在作为对象属性访问时会 &lt;strong&gt;自动解包&lt;/strong&gt;；作为 &lt;strong&gt;数组元素或 &lt;code&gt;Map&lt;/code&gt; 值&lt;/strong&gt; 访问时 &lt;strong&gt;不解包&lt;/strong&gt;，仍需 &lt;code&gt;.value&lt;/code&gt;。&lt;/li&gt;
&lt;li&gt;对同一对象多次 &lt;code&gt;reactive()&lt;/code&gt; 返回 &lt;strong&gt;同一 proxy&lt;/strong&gt;；对已有 proxy 再 &lt;code&gt;reactive()&lt;/code&gt; 仍返回该 proxy。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;reactive&lt;/code&gt; 代理与原对象用 &lt;code&gt;===&lt;/code&gt; 比较为 &lt;strong&gt;false&lt;/strong&gt;。务必始终通过 proxy 访问，不要混用原对象与代理。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;shallowRef&lt;/code&gt;：只改 &lt;code&gt;state.value.count&lt;/code&gt; &lt;strong&gt;不会&lt;/strong&gt;触发依赖；替换 &lt;code&gt;state.value = {...}&lt;/code&gt; 才会。需要在浅层 ref 上做深变更后强制更新时，用 &lt;code&gt;triggerRef(shallow)&lt;/code&gt;。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="实践一最小可运行依赖图"&gt;&lt;a href="#%e5%ae%9e%e8%b7%b5%e4%b8%80%e6%9c%80%e5%b0%8f%e5%8f%af%e8%bf%90%e8%a1%8c%e4%be%9d%e8%b5%96%e5%9b%be" class="header-anchor"&gt;&lt;/a&gt;实践一：最小可运行依赖图
&lt;/h2&gt;&lt;p&gt;下面用 Node + Vue 运行时演示 track/trigger（无需浏览器）：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 任选一种安装方式&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;npm init -y
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;npm i vue@3
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-js" data-lang="js"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;// lab-reactivity.mjs
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;ref&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;reactive&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;computed&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;watch&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;watchEffect&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;shallowRef&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;triggerRef&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;toRaw&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;isReactive&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="nx"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;vue&amp;#39;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;count&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;ref&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;doubled&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;computed&lt;/span&gt;&lt;span class="p"&gt;(()&lt;/span&gt; &lt;span class="p"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;count&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt; &lt;span class="o"&gt;*&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;logs&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[]&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;stop&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;watchEffect&lt;/span&gt;&lt;span class="p"&gt;(()&lt;/span&gt; &lt;span class="p"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;logs&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sb"&gt;`effect: count=&lt;/span&gt;&lt;span class="si"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;count&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sb"&gt;, doubled=&lt;/span&gt;&lt;span class="si"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;doubled&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sb"&gt;`&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;})&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;count&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;count&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;stop&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;logs&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;// 首次 + 两次变更，共 3 条（具体实现细节可能批量，但依赖关系清晰）
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;// Proxy 身份
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;raw&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;n&lt;/span&gt;&lt;span class="o"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;1&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;state&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;reactive&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;raw&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;proxy===raw?&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;state&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="nx"&gt;raw&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="c1"&gt;// false
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;toRaw(state)===raw?&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;toRaw&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;state&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="nx"&gt;raw&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="c1"&gt;// true
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;isReactive(state)&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;isReactive&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;state&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt; &lt;span class="c1"&gt;// true
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;// 浅层 ref
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;bag&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;shallowRef&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="nx"&gt;items&lt;/span&gt;&lt;span class="o"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="mi"&gt;1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;3&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="nx"&gt;shallowHits&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;watchEffect&lt;/span&gt;&lt;span class="p"&gt;(()&lt;/span&gt; &lt;span class="p"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;shallowHits&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="c1"&gt;// 仅读取 .value 建立依赖；内部字段变更不自动 trigger
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;bag size hint&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;bag&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;items&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;})&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;bag&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;items&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;push&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="c1"&gt;// 通常不会再次触发 effect
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;triggerRef&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;bag&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="c1"&gt;// 手动 trigger
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;shallowHits after triggerRef&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;shallowHits&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;运行：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;node lab-reactivity.mjs
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;观察点：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;code&gt;watchEffect&lt;/code&gt; 首次即执行，读 &lt;code&gt;count&lt;/code&gt; / &lt;code&gt;doubled&lt;/code&gt; 完成订阅。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;state === raw&lt;/code&gt; 为 false，但 &lt;code&gt;toRaw(state) === raw&lt;/code&gt; 为 true。&lt;/li&gt;
&lt;li&gt;&lt;code&gt;shallowRef&lt;/code&gt; 内部 &lt;code&gt;push&lt;/code&gt; 不自动更新依赖，&lt;code&gt;triggerRef&lt;/code&gt; 后才会。&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id="实践二组件里常见写法与正确边界"&gt;&lt;a href="#%e5%ae%9e%e8%b7%b5%e4%ba%8c%e7%bb%84%e4%bb%b6%e9%87%8c%e5%b8%b8%e8%a7%81%e5%86%99%e6%b3%95%e4%b8%8e%e6%ad%a3%e7%a1%ae%e8%be%b9%e7%95%8c" class="header-anchor"&gt;&lt;/a&gt;实践二：组件里常见写法与正确边界
&lt;/h2&gt;&lt;h3 id="解构与丢响应"&gt;&lt;a href="#%e8%a7%a3%e6%9e%84%e4%b8%8e%e4%b8%a2%e5%93%8d%e5%ba%94" class="header-anchor"&gt;&lt;/a&gt;解构与“丢响应”
&lt;/h3&gt;&lt;p&gt;把 &lt;code&gt;reactive&lt;/code&gt; 对象的属性赋给局部变量后，再读写局部变量 &lt;strong&gt;不再经过 Proxy trap&lt;/strong&gt;，因此不再响应式。若局部变量指向对象，&lt;strong&gt;修改该对象内部&lt;/strong&gt;仍可能触发（因为仍是代理对象），但“换绑”到另一个值不会：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-js" data-lang="js"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;reactive&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;toRefs&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="nx"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;vue&amp;#39;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;state&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;reactive&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="nx"&gt;count&lt;/span&gt;&lt;span class="o"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;user&lt;/span&gt;&lt;span class="o"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;name&lt;/span&gt;&lt;span class="o"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;Ada&amp;#39;&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;// 丢：基本类型解构成局部变量
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kd"&gt;let&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;count&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;state&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;count&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt; &lt;span class="c1"&gt;// 不触发视图
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;// 保：保持在 proxy 上访问
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;state&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;count&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;// 保：需要解构时用 toRefs，得到一堆 ref
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;count&lt;/span&gt;&lt;span class="o"&gt;:&lt;/span&gt; &lt;span class="nx"&gt;countRef&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;toRefs&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;state&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;countRef&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="o"&gt;++&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="watch-vs-watcheffect"&gt;&lt;a href="#watch-vs-watcheffect" class="header-anchor"&gt;&lt;/a&gt;&lt;code&gt;watch&lt;/code&gt; vs &lt;code&gt;watchEffect&lt;/code&gt;
&lt;/h3&gt;&lt;table&gt;
	&lt;thead&gt;
			&lt;tr&gt;
					&lt;th&gt;&lt;/th&gt;
					&lt;th&gt;&lt;code&gt;watchEffect&lt;/code&gt;&lt;/th&gt;
					&lt;th&gt;&lt;code&gt;watch&lt;/code&gt;&lt;/th&gt;
			&lt;/tr&gt;
	&lt;/thead&gt;
	&lt;tbody&gt;
			&lt;tr&gt;
					&lt;td&gt;首次执行&lt;/td&gt;
					&lt;td&gt;立即&lt;/td&gt;
					&lt;td&gt;默认懒执行（&lt;code&gt;immediate: true&lt;/code&gt; 可立刻跑）&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;依赖声明&lt;/td&gt;
					&lt;td&gt;执行时自动收集&lt;/td&gt;
					&lt;td&gt;显式 source（ref / getter / reactive / 数组）&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;新旧值&lt;/td&gt;
					&lt;td&gt;无&lt;/td&gt;
					&lt;td&gt;回调拿到 &lt;code&gt;newValue&lt;/code&gt; / &lt;code&gt;oldValue&lt;/code&gt;&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;深度&lt;/td&gt;
					&lt;td&gt;读到即收集&lt;/td&gt;
					&lt;td&gt;直接 watch reactive 对象时隐式 deep；getter 默认浅&lt;/td&gt;
			&lt;/tr&gt;
	&lt;/tbody&gt;
&lt;/table&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-js" data-lang="js"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;ref&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;reactive&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;watch&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;watchEffect&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="nx"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;vue&amp;#39;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;id&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;ref&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;a&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;state&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;reactive&lt;/span&gt;&lt;span class="p"&gt;({&lt;/span&gt; &lt;span class="nx"&gt;nested&lt;/span&gt;&lt;span class="o"&gt;:&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;n&lt;/span&gt;&lt;span class="o"&gt;:&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;// 自动收集 id
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;watchEffect&lt;/span&gt;&lt;span class="p"&gt;(()&lt;/span&gt; &lt;span class="p"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;load&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;id&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;})&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;// 精确 source + 新旧值
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;watch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;id&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;next&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;prev&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;id changed&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;prev&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;-&amp;gt;&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;next&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;})&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;// 直接 watch reactive → 深监听；深层 mutation 时 new===old
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;watch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;state&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;nv&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;ov&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;deep mutate&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;nv&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="nx"&gt;ov&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="c1"&gt;// true（对象引用未换）
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;})&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;// getter 默认只在返回值“变”时触发；要深层需 { deep: true }
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;watch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="p"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;state&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;nested&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;()&lt;/span&gt; &lt;span class="p"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="nx"&gt;console&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;log&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s1"&gt;&amp;#39;nested replaced or deep&amp;#39;&lt;/span&gt;&lt;span class="p"&gt;),&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;deep&lt;/span&gt;&lt;span class="o"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h3 id="flush-时序pre--post--sync"&gt;&lt;a href="#flush-%e6%97%b6%e5%ba%8fpre--post--sync" class="header-anchor"&gt;&lt;/a&gt;flush 时序：&lt;code&gt;pre&lt;/code&gt; / &lt;code&gt;post&lt;/code&gt; / &lt;code&gt;sync&lt;/code&gt;
&lt;/h3&gt;&lt;p&gt;状态变更可能同时触发组件更新与用户 watcher。默认会 &lt;strong&gt;批量&lt;/strong&gt;，避免数组连续 &lt;code&gt;push&lt;/code&gt; 一千次就回调一千次。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;默认 &lt;code&gt;flush: 'pre'&lt;/code&gt;&lt;/strong&gt;：在父组件更新之后、&lt;strong&gt;拥有者组件 DOM 更新之前&lt;/strong&gt;调用。此时读自己的 DOM 仍是更新前状态。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;flush: 'post'&lt;/code&gt;&lt;/strong&gt;（或 &lt;code&gt;watchPostEffect&lt;/code&gt;）：在 DOM 更新后执行，适合量尺寸、聚焦输入框。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;code&gt;flush: 'sync'&lt;/code&gt;&lt;/strong&gt;（或 &lt;code&gt;watchSyncEffect&lt;/code&gt;）：依赖一变立刻同步跑；官方提醒可能带来性能与一致性问题，仅在少数缓存失效场景使用。&lt;/li&gt;
&lt;/ul&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-js" data-lang="js"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;watch&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;source&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;cb&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;flush&lt;/span&gt;&lt;span class="o"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;post&amp;#39;&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;组件渲染本身也不是同步刷 DOM：变更后会缓冲到更新周期的 &lt;strong&gt;next tick&lt;/strong&gt;，保证同一轮同步代码里多次改状态只渲染一次。需要等 DOM 落地时用 &lt;code&gt;nextTick()&lt;/code&gt;。&lt;/p&gt;
&lt;h3 id="异步创建-watcher-必须手动-stop"&gt;&lt;a href="#%e5%bc%82%e6%ad%a5%e5%88%9b%e5%bb%ba-watcher-%e5%bf%85%e9%a1%bb%e6%89%8b%e5%8a%a8-stop" class="header-anchor"&gt;&lt;/a&gt;异步创建 watcher 必须手动 stop
&lt;/h3&gt;&lt;p&gt;在 &lt;code&gt;setup&lt;/code&gt; / &lt;code&gt;&amp;lt;script setup&amp;gt;&lt;/code&gt; &lt;strong&gt;同步&lt;/strong&gt;创建的 &lt;code&gt;watch&lt;/code&gt; / &lt;code&gt;watchEffect&lt;/code&gt; 会绑定组件实例，卸载时自动停止。若在 &lt;code&gt;setTimeout&lt;/code&gt;、&lt;code&gt;then&lt;/code&gt; 等异步回调里创建，&lt;strong&gt;不会&lt;/strong&gt;自动绑定，需保存返回句柄并 &lt;code&gt;stop()&lt;/code&gt;，否则泄漏：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-js" data-lang="js"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;// 危险
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;setTimeout&lt;/span&gt;&lt;span class="p"&gt;(()&lt;/span&gt; &lt;span class="p"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;watchEffect&lt;/span&gt;&lt;span class="p"&gt;(()&lt;/span&gt; &lt;span class="p"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="cm"&gt;/* ... */&lt;/span&gt; &lt;span class="p"&gt;})&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;},&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;// 正确：尽量同步创建；或
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;stop&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;watchEffect&lt;/span&gt;&lt;span class="p"&gt;(()&lt;/span&gt; &lt;span class="p"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{})&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;// 不再需要时
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nx"&gt;stop&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;副作用清理（取消上一次请求）可用回调第三个参数 &lt;code&gt;onCleanup&lt;/code&gt;，或 Vue 3.5+ 的 &lt;code&gt;onWatcherCleanup&lt;/code&gt;（须在 watcher 同步执行阶段注册，不能写在 &lt;code&gt;await&lt;/code&gt; 之后）。&lt;/p&gt;
&lt;h3 id="外部状态--大列表shallowref-模式"&gt;&lt;a href="#%e5%a4%96%e9%83%a8%e7%8a%b6%e6%80%81--%e5%a4%a7%e5%88%97%e8%a1%a8shallowref-%e6%a8%a1%e5%bc%8f" class="header-anchor"&gt;&lt;/a&gt;外部状态 / 大列表：shallowRef 模式
&lt;/h3&gt;&lt;p&gt;对接 Immer、XState、不可变快照时，官方推荐 &lt;strong&gt;用 &lt;code&gt;shallowRef&lt;/code&gt; 持有外部状态&lt;/strong&gt;，状态变更时 &lt;strong&gt;替换 &lt;code&gt;.value&lt;/code&gt;&lt;/strong&gt; 触发更新，而不是深代理整棵树：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-js" data-lang="js"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;shallowRef&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="nx"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;vue&amp;#39;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;import&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="nx"&gt;produce&lt;/span&gt; &lt;span class="p"&gt;}&lt;/span&gt; &lt;span class="nx"&gt;from&lt;/span&gt; &lt;span class="s1"&gt;&amp;#39;immer&amp;#39;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="kr"&gt;export&lt;/span&gt; &lt;span class="kd"&gt;function&lt;/span&gt; &lt;span class="nx"&gt;useImmer&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;baseState&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;state&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;shallowRef&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;baseState&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="kr"&gt;const&lt;/span&gt; &lt;span class="nx"&gt;update&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;updater&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;=&amp;gt;&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="nx"&gt;state&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="nx"&gt;produce&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;state&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;value&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;updater&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt; &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="nx"&gt;state&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="nx"&gt;update&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id="实践三排错清单从现象到机制"&gt;&lt;a href="#%e5%ae%9e%e8%b7%b5%e4%b8%89%e6%8e%92%e9%94%99%e6%b8%85%e5%8d%95%e4%bb%8e%e7%8e%b0%e8%b1%a1%e5%88%b0%e6%9c%ba%e5%88%b6" class="header-anchor"&gt;&lt;/a&gt;实践三：排错清单（从现象到机制）
&lt;/h2&gt;&lt;table&gt;
	&lt;thead&gt;
			&lt;tr&gt;
					&lt;th&gt;现象&lt;/th&gt;
					&lt;th&gt;可能原因&lt;/th&gt;
					&lt;th&gt;排查/修法&lt;/th&gt;
			&lt;/tr&gt;
	&lt;/thead&gt;
	&lt;tbody&gt;
			&lt;tr&gt;
					&lt;td&gt;改了字段 UI 不动&lt;/td&gt;
					&lt;td&gt;改的是原对象而非 proxy；或 Options API 里运行时往 &lt;code&gt;this&lt;/code&gt; 上动态加未在 &lt;code&gt;data&lt;/code&gt; 声明的字段&lt;/td&gt;
					&lt;td&gt;始终通过 &lt;code&gt;reactive&lt;/code&gt;/&lt;code&gt;ref&lt;/code&gt;/组件状态访问；预声明字段&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;解构后失效&lt;/td&gt;
					&lt;td&gt;基本类型离开 proxy trap&lt;/td&gt;
					&lt;td&gt;&lt;code&gt;toRefs&lt;/code&gt; / 保持 &lt;code&gt;state.x&lt;/code&gt; / 用 &lt;code&gt;ref&lt;/code&gt;&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;&lt;code&gt;===&lt;/code&gt; 意外 false&lt;/td&gt;
					&lt;td&gt;proxy 与 raw 身份不同&lt;/td&gt;
					&lt;td&gt;&lt;code&gt;toRaw&lt;/code&gt; 比对；不要缓存 raw 再与 proxy 混比&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;深 watch 里 new===old&lt;/td&gt;
					&lt;td&gt;同一对象引用上的深层 mutation&lt;/td&gt;
					&lt;td&gt;预期行为；需要 diff 时自行对比字段或换不可变更新&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;watch 不跑&lt;/td&gt;
					&lt;td&gt;默认 lazy；或 getter 只返回同一对象引用&lt;/td&gt;
					&lt;td&gt;&lt;code&gt;immediate: true&lt;/code&gt;；&lt;code&gt;deep: true&lt;/code&gt; 或 watch reactive 本体&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;大列表卡顿&lt;/td&gt;
					&lt;td&gt;深代理整表&lt;/td&gt;
					&lt;td&gt;&lt;code&gt;shallowRef&lt;/code&gt; + 替换引用；&lt;code&gt;markRaw&lt;/code&gt; 固定第三方实例&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;卸载后仍请求&lt;/td&gt;
					&lt;td&gt;异步创建的 effect 未 stop / 未 onCleanup&lt;/td&gt;
					&lt;td&gt;同步创建或手动 stop；请求取消挂到 cleanup&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;Dev 难查谁触发渲染&lt;/td&gt;
					&lt;td&gt;依赖图不透明&lt;/td&gt;
					&lt;td&gt;&lt;code&gt;onRenderTracked&lt;/code&gt; / &lt;code&gt;onRenderTriggered&lt;/code&gt;；&lt;code&gt;computed&lt;/code&gt;/&lt;code&gt;watch&lt;/code&gt; 的 &lt;code&gt;onTrack&lt;/code&gt;/&lt;code&gt;onTrigger&lt;/code&gt;（仅开发模式）&lt;/td&gt;
			&lt;/tr&gt;
	&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;调试钩子事件形状（开发模式）大致包含：&lt;code&gt;effect&lt;/code&gt;、&lt;code&gt;target&lt;/code&gt;、&lt;code&gt;type&lt;/code&gt;（track: &lt;code&gt;get|has|iterate&lt;/code&gt;；trigger: &lt;code&gt;set|add|delete|clear&lt;/code&gt;）、&lt;code&gt;key&lt;/code&gt;、新旧值等，便于在 DevTools 里下断点。&lt;/p&gt;
&lt;h2 id="与-signals--编译期响应式的位置"&gt;&lt;a href="#%e4%b8%8e-signals--%e7%bc%96%e8%af%91%e6%9c%9f%e5%93%8d%e5%ba%94%e5%bc%8f%e7%9a%84%e4%bd%8d%e7%bd%ae" class="header-anchor"&gt;&lt;/a&gt;与 Signals / 编译期响应式的位置
&lt;/h2&gt;&lt;p&gt;官方把 Vue &lt;code&gt;ref&lt;/code&gt; 与 Solid/Angular/Preact 等 &lt;strong&gt;signals&lt;/strong&gt; 归为同类原语：值容器 + 访问时收集依赖 + 变更时触发副作用。Vue 目前渲染仍以 Virtual DOM 为主，并借助编译优化；运行时响应式的优点是可无构建步骤、边界情况相对少；代价是受 JS 语法限制，需要 &lt;code&gt;.value&lt;/code&gt; 这类容器。团队曾探索 &lt;em&gt;Reactivity Transform&lt;/em&gt;，最终未作为项目方向推进——工程上仍应以稳定的 runtime API 为准。&lt;/p&gt;
&lt;h2 id="总结"&gt;&lt;a href="#%e6%80%bb%e7%bb%93" class="header-anchor"&gt;&lt;/a&gt;总结
&lt;/h2&gt;&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;机制&lt;/strong&gt;：&lt;code&gt;Proxy&lt;/code&gt;（对象）与 getter/setter（ref）在读时 &lt;code&gt;track&lt;/code&gt;、写时 &lt;code&gt;trigger&lt;/code&gt;；订阅表概念上是 &lt;code&gt;WeakMap → Map → Set&lt;/code&gt;；&lt;code&gt;activeEffect&lt;/code&gt; 把“当前执行的副作用”挂到读路径上。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;选型&lt;/strong&gt;：日常优先 &lt;code&gt;ref&lt;/code&gt;；对象图用 &lt;code&gt;reactive&lt;/code&gt; 但警惕身份与解构；大对象/外部库用 &lt;code&gt;shallowRef&lt;/code&gt;/&lt;code&gt;markRaw&lt;/code&gt;；对外暴露用 &lt;code&gt;readonly&lt;/code&gt;。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;副作用&lt;/strong&gt;：派生用 &lt;code&gt;computed&lt;/code&gt;；带新旧值与精确 source 用 &lt;code&gt;watch&lt;/code&gt;；自动依赖用 &lt;code&gt;watchEffect&lt;/code&gt;；注意 &lt;code&gt;flush&lt;/code&gt;、批量更新与 &lt;code&gt;nextTick&lt;/code&gt;。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;生命周期&lt;/strong&gt;：同步创建的 watcher 随组件卸载；异步创建必须手动 &lt;code&gt;stop&lt;/code&gt;，请求类副作用要 &lt;code&gt;onCleanup&lt;/code&gt;。&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;排错&lt;/strong&gt;：先问“这次读写有没有经过 trap？依赖是不是期望的那一个 key？触发的是替换引用还是原地 mutation？”&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;理解 track/trigger 之后，很多“玄学不更新”会变成可定位的契约问题，而不是框架黑盒。&lt;/p&gt;
&lt;h2 id="参考资料"&gt;&lt;a href="#%e5%8f%82%e8%80%83%e8%b5%84%e6%96%99" class="header-anchor"&gt;&lt;/a&gt;参考资料
&lt;/h2&gt;&lt;ol&gt;
&lt;li&gt;&lt;a class="link" href="https://vuejs.org/guide/extras/reactivity-in-depth.html" target="_blank" rel="noopener"
 &gt;Vue.js — Reactivity in Depth&lt;/a&gt;（机制伪代码、WeakMap 依赖结构、调试钩子、外部状态集成）&lt;/li&gt;
&lt;li&gt;&lt;a class="link" href="https://vuejs.org/guide/essentials/reactivity-fundamentals.html" target="_blank" rel="noopener"
 &gt;Vue.js — Reactivity Fundamentals&lt;/a&gt;（ref/reactive、深响应、Proxy 与原对象、DOM 更新时序）&lt;/li&gt;
&lt;li&gt;&lt;a class="link" href="https://vuejs.org/guide/essentials/watchers.html" target="_blank" rel="noopener"
 &gt;Vue.js — Watchers&lt;/a&gt;（watch/watchEffect、deep/immediate、flush、停止与泄漏）&lt;/li&gt;
&lt;li&gt;&lt;a class="link" href="https://vuejs.org/api/reactivity-core.html" target="_blank" rel="noopener"
 &gt;Vue.js — Reactivity API: Core&lt;/a&gt;（ref/computed/reactive/readonly/watch* 类型与行为）&lt;/li&gt;
&lt;li&gt;&lt;a class="link" href="https://vuejs.org/api/reactivity-advanced.html" target="_blank" rel="noopener"
 &gt;Vue.js — Reactivity API: Advanced&lt;/a&gt;（shallowRef、triggerRef、customRef、toRaw、markRaw、effectScope）&lt;/li&gt;
&lt;li&gt;&lt;a class="link" href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy" target="_blank" rel="noopener"
 &gt;MDN — Proxy&lt;/a&gt;（属性访问拦截的语言基础）&lt;/li&gt;
&lt;/ol&gt;</description></item><item><title>Node.js 2026 年 6 月安全发布：22/24/26 版本线升级与排查指南</title><link>https://blog.waihost.com/posts/nodejs-june-2026-security-release-guide/</link><pubDate>Thu, 02 Jul 2026 01:16:08 +0000</pubDate><guid>https://blog.waihost.com/posts/nodejs-june-2026-security-release-guide/</guid><description>&lt;img src="https://blog.waihost.com/images/covers/nodejs-june-2026-security-release-guide.svg" alt="Featured image of post Node.js 2026 年 6 月安全发布：22/24/26 版本线升级与排查指南" /&gt;&lt;p&gt;Node.js 项目在 2026 年 6 月 18 日发布了一组安全更新，覆盖 &lt;code&gt;26.x&lt;/code&gt;、&lt;code&gt;24.x&lt;/code&gt;、&lt;code&gt;22.x&lt;/code&gt; 三条仍受支持的发布线。对线上服务来说，这不是一次“可有可无”的例行小版本：官方公告中最高风险等级为 &lt;strong&gt;High&lt;/strong&gt;，并同时修复了 WebCrypto、TLS 主机名校验、HTTP/2、代理错误信息、Permission Model 等多个方向的问题。&lt;/p&gt;
&lt;p&gt;如果你的生产环境仍在使用 Node.js 22、24 或 26，建议把这次更新当作一次安全基线升级来处理：先识别运行版本，再按发布线升级到对应修复版本，最后用针对性的回归测试覆盖 TLS、HTTP/2、代理、权限模型和大数据加密场景。&lt;/p&gt;
&lt;h2 id="先看结论应该升级到哪些版本"&gt;&lt;a href="#%e5%85%88%e7%9c%8b%e7%bb%93%e8%ae%ba%e5%ba%94%e8%af%a5%e5%8d%87%e7%ba%a7%e5%88%b0%e5%93%aa%e4%ba%9b%e7%89%88%e6%9c%ac" class="header-anchor"&gt;&lt;/a&gt;先看结论：应该升级到哪些版本
&lt;/h2&gt;&lt;p&gt;这次安全发布对应的修复版本如下：&lt;/p&gt;
&lt;table&gt;
	&lt;thead&gt;
			&lt;tr&gt;
					&lt;th&gt;发布线&lt;/th&gt;
					&lt;th style="text-align: right"&gt;修复版本&lt;/th&gt;
					&lt;th&gt;版本状态&lt;/th&gt;
					&lt;th&gt;备注&lt;/th&gt;
			&lt;/tr&gt;
	&lt;/thead&gt;
	&lt;tbody&gt;
			&lt;tr&gt;
					&lt;td&gt;Node.js 22&lt;/td&gt;
					&lt;td style="text-align: right"&gt;&lt;code&gt;v22.23.0&lt;/code&gt;&lt;/td&gt;
					&lt;td&gt;LTS，代号 &lt;code&gt;Jod&lt;/code&gt;&lt;/td&gt;
					&lt;td&gt;安全发布，适合仍在 22 LTS 的生产系统&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;Node.js 24&lt;/td&gt;
					&lt;td style="text-align: right"&gt;&lt;code&gt;v24.17.0&lt;/code&gt;&lt;/td&gt;
					&lt;td&gt;LTS，代号 &lt;code&gt;Krypton&lt;/code&gt;&lt;/td&gt;
					&lt;td&gt;安全发布，适合 24 LTS 生产系统&lt;/td&gt;
			&lt;/tr&gt;
			&lt;tr&gt;
					&lt;td&gt;Node.js 26&lt;/td&gt;
					&lt;td style="text-align: right"&gt;&lt;code&gt;v26.3.1&lt;/code&gt;&lt;/td&gt;
					&lt;td&gt;Current&lt;/td&gt;
					&lt;td&gt;安全发布，适合已经采用 26 Current 的系统&lt;/td&gt;
			&lt;/tr&gt;
	&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;官方发布索引显示，这三个版本的发布日期均为 &lt;code&gt;2026-06-17&lt;/code&gt;，并带有 security 标记；官方博客随后在 &lt;code&gt;2026-06-18&lt;/code&gt; 更新公告，说明安全版本已经可用。&lt;/p&gt;
&lt;p&gt;另外，Node.js 发布计划显示：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;v22&lt;/code&gt; 的维护期到 &lt;code&gt;2027-04-30&lt;/code&gt;，LTS 代号为 &lt;code&gt;Jod&lt;/code&gt;；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;v24&lt;/code&gt; 的维护期到 &lt;code&gt;2028-04-30&lt;/code&gt;，LTS 代号为 &lt;code&gt;Krypton&lt;/code&gt;；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;v26&lt;/code&gt; 在 &lt;code&gt;2026-05-05&lt;/code&gt; 开始，计划于 &lt;code&gt;2026-10-28&lt;/code&gt; 进入 LTS，当前仍是 Current 线。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;因此，保守生产系统通常应优先停留在当前 LTS 线并升级补丁版本；已经使用 Current 的团队，则应尽快吸收 &lt;code&gt;v26.3.1&lt;/code&gt; 或后续包含该修复的更高版本。&lt;/p&gt;
&lt;h2 id="这次修复覆盖了哪些风险"&gt;&lt;a href="#%e8%bf%99%e6%ac%a1%e4%bf%ae%e5%a4%8d%e8%a6%86%e7%9b%96%e4%ba%86%e5%93%aa%e4%ba%9b%e9%a3%8e%e9%99%a9" class="header-anchor"&gt;&lt;/a&gt;这次修复覆盖了哪些风险
&lt;/h2&gt;&lt;p&gt;官方公告列出的修复点较多，可以按工程影响分成几类理解。&lt;/p&gt;
&lt;h3 id="1-webcrypto超大输入可能导致进程中止"&gt;&lt;a href="#1-webcrypto%e8%b6%85%e5%a4%a7%e8%be%93%e5%85%a5%e5%8f%af%e8%83%bd%e5%af%bc%e8%87%b4%e8%bf%9b%e7%a8%8b%e4%b8%ad%e6%ad%a2" class="header-anchor"&gt;&lt;/a&gt;1. WebCrypto：超大输入可能导致进程中止
&lt;/h3&gt;&lt;p&gt;&lt;code&gt;CVE-2026-48933&lt;/code&gt; 影响 Node.js WebCrypto 的 AES 加密实现。当 &lt;code&gt;subtle.encrypt()&lt;/code&gt; 的输入大小是 &lt;code&gt;2GiB&lt;/code&gt; 的倍数时，可能触发整数溢出并导致进程崩溃，官方定级为 High。&lt;/p&gt;
&lt;p&gt;这类问题对常规 API 服务未必高频触发，但对以下场景值得重点检查：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;服务允许用户上传或处理超大二进制文件；&lt;/li&gt;
&lt;li&gt;使用 WebCrypto 做文件级加密、备份加密或对象存储前置加密；&lt;/li&gt;
&lt;li&gt;加密任务运行在常驻 Node.js worker 中，进程崩溃会影响队列消费或批处理任务。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;升级之外，还建议在业务层对单次加密输入设置合理上限，避免把“超大对象完整读入内存后一次性加密”作为默认实现。&lt;/p&gt;
&lt;h3 id="2-tls--mtls主机名规范化与会话复用相关绕过"&gt;&lt;a href="#2-tls--mtls%e4%b8%bb%e6%9c%ba%e5%90%8d%e8%a7%84%e8%8c%83%e5%8c%96%e4%b8%8e%e4%bc%9a%e8%af%9d%e5%a4%8d%e7%94%a8%e7%9b%b8%e5%85%b3%e7%bb%95%e8%bf%87" class="header-anchor"&gt;&lt;/a&gt;2. TLS / mTLS：主机名规范化与会话复用相关绕过
&lt;/h3&gt;&lt;p&gt;本次公告中多项漏洞与 TLS 主机名处理有关，包括：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;CVE-2026-48618&lt;/code&gt;：Unicode 点分隔符处理与解析器、校验器之间的主机名规范化不一致，可能导致通配符深度认证绕过；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;CVE-2026-48928&lt;/code&gt;：SNI 上下文匹配存在大小写敏感问题，在多上下文 mTLS 场景下可能绕过授权策略；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;CVE-2026-48930&lt;/code&gt;：嵌入 NUL 字符的主机名可能因为 C 字符串截断造成 authority rebinding；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;CVE-2026-48934&lt;/code&gt;：不同 &lt;code&gt;servername&lt;/code&gt; 的 TLS 会话复用可能导致主机身份校验绕过。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;这些问题对普通内部脚本也许不明显，但对网关、反向代理、服务网格边车、BFF、Webhook 分发器、多租户 mTLS 接入层影响更大。升级后建议重点回归：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;使用通配符证书的 HTTPS 客户端连接；&lt;/li&gt;
&lt;li&gt;同一进程内面向多个上游域名的 keep-alive / TLS session 复用；&lt;/li&gt;
&lt;li&gt;mTLS 中按 SNI 或证书主机名选择租户、策略、证书链的逻辑；&lt;/li&gt;
&lt;li&gt;对国际化域名、大小写混合域名、异常主机名输入的拒绝策略。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;如果业务代码里手写了 &lt;code&gt;checkServerIdentity&lt;/code&gt; 或自定义 &lt;code&gt;tls.connect()&lt;/code&gt; 参数，也应把这些路径纳入审计。&lt;/p&gt;
&lt;h3 id="3-http2客户端内存增长与服务端-goaway-清理问题"&gt;&lt;a href="#3-http2%e5%ae%a2%e6%88%b7%e7%ab%af%e5%86%85%e5%ad%98%e5%a2%9e%e9%95%bf%e4%b8%8e%e6%9c%8d%e5%8a%a1%e7%ab%af-goaway-%e6%b8%85%e7%90%86%e9%97%ae%e9%a2%98" class="header-anchor"&gt;&lt;/a&gt;3. HTTP/2：客户端内存增长与服务端 GOAWAY 清理问题
&lt;/h3&gt;&lt;p&gt;公告列出两个 HTTP/2 相关问题：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;CVE-2026-48619&lt;/code&gt;：HTTP/2 客户端可能因为攻击者控制的 &lt;code&gt;ORIGIN&lt;/code&gt; frame 出现无界内存增长，最终导致 OOM；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;CVE-2026-48937&lt;/code&gt;：HTTP/2 服务端在无效协议错误后发送 &lt;code&gt;GOAWAY&lt;/code&gt;，但 session 未正确清理，仍可能继续接收数据。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;如果你的 Node.js 服务直接使用 &lt;code&gt;node:http2&lt;/code&gt;，或运行在会与不可信上游/下游建立 HTTP/2 连接的代理组件中，升级后建议做两类验证：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;压测长连接场景，观察连接关闭、错误、重连后内存是否稳定；&lt;/li&gt;
&lt;li&gt;在网关、服务端渲染、爬虫、聚合 API 等客户端角色中，确认异常 HTTP/2 响应不会让 worker 内存持续增长。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;即使框架层封装了 HTTP/2，也不要只测 HTTP/1.1 路径。&lt;/p&gt;
&lt;h3 id="4-代理与日志凭据可能进入错误信息"&gt;&lt;a href="#4-%e4%bb%a3%e7%90%86%e4%b8%8e%e6%97%a5%e5%bf%97%e5%87%ad%e6%8d%ae%e5%8f%af%e8%83%bd%e8%bf%9b%e5%85%a5%e9%94%99%e8%af%af%e4%bf%a1%e6%81%af" class="header-anchor"&gt;&lt;/a&gt;4. 代理与日志：凭据可能进入错误信息
&lt;/h3&gt;&lt;p&gt;&lt;code&gt;CVE-2026-48615&lt;/code&gt; 与 &lt;code&gt;ERR_PROXY_TUNNEL&lt;/code&gt; 错误处理有关。当代理凭据嵌入代理 URL 时，错误信息中可能泄露这些凭据，并被日志、诊断系统或错误上报平台采集。&lt;/p&gt;
&lt;p&gt;升级运行时后，还建议额外做一次配置治理：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;不要在日志中直接打印完整代理 URL；&lt;/li&gt;
&lt;li&gt;对 &lt;code&gt;HTTP_PROXY&lt;/code&gt;、&lt;code&gt;HTTPS_PROXY&lt;/code&gt;、&lt;code&gt;NO_PROXY&lt;/code&gt;、自定义代理配置做脱敏；&lt;/li&gt;
&lt;li&gt;在日志平台中搜索历史 &lt;code&gt;ERR_PROXY_TUNNEL&lt;/code&gt;、&lt;code&gt;proxy&lt;/code&gt;、&lt;code&gt;@&lt;/code&gt; 等关键词，评估是否已有敏感信息进入日志；&lt;/li&gt;
&lt;li&gt;优先使用密钥管理系统或运行时注入，而不是把代理账号密码写入仓库配置文件。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;这类漏洞的直接修复在运行时，但真正的风险收敛通常还包括日志脱敏和凭据轮换。&lt;/p&gt;
&lt;h3 id="5-permission-model仍需谨慎对待实验性隔离能力"&gt;&lt;a href="#5-permission-model%e4%bb%8d%e9%9c%80%e8%b0%a8%e6%85%8e%e5%af%b9%e5%be%85%e5%ae%9e%e9%aa%8c%e6%80%a7%e9%9a%94%e7%a6%bb%e8%83%bd%e5%8a%9b" class="header-anchor"&gt;&lt;/a&gt;5. Permission Model：仍需谨慎对待实验性隔离能力
&lt;/h3&gt;&lt;p&gt;本次安全发布还修复了多个 Permission Model 相关问题：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;code&gt;CVE-2026-48617&lt;/code&gt;：&lt;code&gt;process.report.writeReport()&lt;/code&gt; 路径校验问题可能绕过权限模型；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;CVE-2026-48935&lt;/code&gt;：&lt;code&gt;FileHandle.utimes()&lt;/code&gt; 在 promises API 中可能修改只读路径的文件元数据；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;CVE-2026-48936&lt;/code&gt;：Unix domain socket server 可绕过 &lt;code&gt;--permission&lt;/code&gt; 网络限制，这是 &lt;code&gt;CVE-2026-21636&lt;/code&gt; 修复不完整后的补充问题，并且官方说明只影响 Node.js 26。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;如果你已经在容器、插件系统、在线代码执行、CI worker 中尝试 Node.js Permission Model，要注意两点：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;运行时权限模型不能替代容器、seccomp、AppArmor、只读文件系统、网络策略等外层隔离；&lt;/li&gt;
&lt;li&gt;升级后要重新跑“禁止写文件、禁止开网络、禁止生成报告”等负向测试，而不是只看正常用例是否通过。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Permission Model 能降低误用风险，但不应被设计成唯一安全边界。&lt;/p&gt;
&lt;h2 id="升级前的资产盘点"&gt;&lt;a href="#%e5%8d%87%e7%ba%a7%e5%89%8d%e7%9a%84%e8%b5%84%e4%ba%a7%e7%9b%98%e7%82%b9" class="header-anchor"&gt;&lt;/a&gt;升级前的资产盘点
&lt;/h2&gt;&lt;p&gt;建议先在服务器、容器镜像、CI runner、本地开发模板中统一盘点 Node.js 版本。&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;node -v
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;npm -v
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;如果使用 Docker，可以检查基础镜像标签：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;docker images &lt;span class="p"&gt;|&lt;/span&gt; grep node
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;如果服务由 systemd 管理，可以确认实际执行路径：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;systemctl cat your-node-service
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;which node
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;如果使用 nvm、fnm、Volta、asdf 等版本管理器，尤其要注意“交互式 shell 里的版本”和“服务启动时的版本”可能不一致。最终判断标准应是生产进程实际使用的 &lt;code&gt;node&lt;/code&gt; 可执行文件。&lt;/p&gt;
&lt;h2 id="推荐升级路径"&gt;&lt;a href="#%e6%8e%a8%e8%8d%90%e5%8d%87%e7%ba%a7%e8%b7%af%e5%be%84" class="header-anchor"&gt;&lt;/a&gt;推荐升级路径
&lt;/h2&gt;&lt;h3 id="使用官方二进制或系统包"&gt;&lt;a href="#%e4%bd%bf%e7%94%a8%e5%ae%98%e6%96%b9%e4%ba%8c%e8%bf%9b%e5%88%b6%e6%88%96%e7%b3%bb%e7%bb%9f%e5%8c%85" class="header-anchor"&gt;&lt;/a&gt;使用官方二进制或系统包
&lt;/h3&gt;&lt;p&gt;如果你的部署方式是官方二进制、NodeSource、发行版包或内部镜像，原则是升级到同一发布线的修复版本或后续补丁版本：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 示例：确认升级后版本&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;node -v
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# 期望看到 v22.23.0 / v24.17.0 / v26.3.1 或更高且包含修复的版本&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;生产环境不建议在同一次安全修复中顺手跨大版本，例如从 22 LTS 直接跳到 26 Current。更稳妥的做法是：先在当前发布线打上安全补丁，再单独规划大版本迁移。&lt;/p&gt;
&lt;h3 id="使用-docker-镜像"&gt;&lt;a href="#%e4%bd%bf%e7%94%a8-docker-%e9%95%9c%e5%83%8f" class="header-anchor"&gt;&lt;/a&gt;使用 Docker 镜像
&lt;/h3&gt;&lt;p&gt;如果服务基于 &lt;code&gt;node&lt;/code&gt; 官方镜像，建议明确固定到补丁版本或内部审核过的基础镜像，而不是长期使用浮动标签：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-dockerfile" data-lang="dockerfile"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;FROM&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;node:24.17.0-bookworm-slim&lt;/span&gt;&lt;span class="err"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;WORKDIR&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s"&gt;/app&lt;/span&gt;&lt;span class="err"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;COPY&lt;/span&gt; package*.json ./&lt;span class="err"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;RUN&lt;/span&gt; npm ci --omit&lt;span class="o"&gt;=&lt;/span&gt;dev&lt;span class="err"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;COPY&lt;/span&gt; . .&lt;span class="err"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="k"&gt;CMD&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;node&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="s2"&gt;&amp;#34;server.js&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="err"&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;镜像升级后要重新构建并触发依赖扫描：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;docker build -t your-app:node-24-17-0 .
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;docker run --rm your-app:node-24-17-0 node -v
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;如果组织内部有统一基础镜像，应优先让平台团队发布修复后的 base image，再由业务服务滚动升级，避免每个仓库各自处理。&lt;/p&gt;
&lt;h3 id="使用-nvm--fnm--volta"&gt;&lt;a href="#%e4%bd%bf%e7%94%a8-nvm--fnm--volta" class="header-anchor"&gt;&lt;/a&gt;使用 nvm / fnm / Volta
&lt;/h3&gt;&lt;p&gt;开发与 CI 环境可以同步更新版本声明文件，例如 &lt;code&gt;.nvmrc&lt;/code&gt;、&lt;code&gt;.node-version&lt;/code&gt; 或 Volta 配置。示例：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="c1"&gt;# .nvmrc&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;24.17.0
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;然后在 CI 中增加版本输出，避免流水线实际使用旧版本：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;node -v
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;npm -v
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;npm ci
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;npm &lt;span class="nb"&gt;test&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id="回归测试清单"&gt;&lt;a href="#%e5%9b%9e%e5%bd%92%e6%b5%8b%e8%af%95%e6%b8%85%e5%8d%95" class="header-anchor"&gt;&lt;/a&gt;回归测试清单
&lt;/h2&gt;&lt;p&gt;这次升级后，建议至少覆盖下面几类测试：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;启动与依赖安装&lt;/strong&gt;：&lt;code&gt;npm ci&lt;/code&gt;、应用启动、健康检查；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;TLS 出站请求&lt;/strong&gt;：访问多个 HTTPS 上游，覆盖 keep-alive、代理、证书校验失败路径；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;mTLS / 多租户接入&lt;/strong&gt;：验证大小写域名、通配符证书、SNI 路由与租户隔离；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;HTTP/2&lt;/strong&gt;：如果使用 &lt;code&gt;node:http2&lt;/code&gt; 或框架启用了 HTTP/2，测试长连接、异常断开、内存稳定性；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;WebCrypto&lt;/strong&gt;：覆盖加密、解密、异常输入、超大输入保护；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Permission Model&lt;/strong&gt;：如果启用 &lt;code&gt;--permission&lt;/code&gt;，同时跑允许与拒绝场景；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;日志脱敏&lt;/strong&gt;：确认代理 URL、凭据、TLS 错误不会原样进入日志平台。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;对高流量服务，建议先在灰度环境观察 RSS、heap、连接数、错误率、HTTP 5xx、TLS 握手失败率，再逐步扩大流量。&lt;/p&gt;
&lt;h2 id="线上排查如何确认已经修复"&gt;&lt;a href="#%e7%ba%bf%e4%b8%8a%e6%8e%92%e6%9f%a5%e5%a6%82%e4%bd%95%e7%a1%ae%e8%ae%a4%e5%b7%b2%e7%bb%8f%e4%bf%ae%e5%a4%8d" class="header-anchor"&gt;&lt;/a&gt;线上排查：如何确认已经修复
&lt;/h2&gt;&lt;p&gt;升级完成后，可以从三个层面确认：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;进程版本&lt;/strong&gt;：在容器或服务器内执行 &lt;code&gt;node -v&lt;/code&gt;，确认不是只更新了镜像标签；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;镜像版本&lt;/strong&gt;：检查部署平台实际拉取的镜像 digest，避免 Kubernetes 或 PaaS 仍运行旧副本；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;日志与指标&lt;/strong&gt;：观察升级后是否仍出现代理凭据泄露、HTTP/2 OOM、TLS 主机名校验异常等问题。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Kubernetes 环境中可以用类似方式确认正在运行的镜像：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;kubectl get pods -l &lt;span class="nv"&gt;app&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;your-app -o wide
&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;kubectl &lt;span class="nb"&gt;exec&lt;/span&gt; deploy/your-app -- node -v
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;如果发现部分副本仍是旧版本，优先检查滚动更新策略、镜像拉取策略、节点缓存与多架构镜像是否同步。&lt;/p&gt;
&lt;h2 id="常见误区"&gt;&lt;a href="#%e5%b8%b8%e8%a7%81%e8%af%af%e5%8c%ba" class="header-anchor"&gt;&lt;/a&gt;常见误区
&lt;/h2&gt;&lt;p&gt;&lt;strong&gt;误区一：只升级开发机，不升级生产镜像。&lt;/strong&gt; 这类安全发布的目标是生产运行时，开发机版本一致只是辅助。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;误区二：看到后续版本就直接跨大版本。&lt;/strong&gt; 如果系统当前在 22 LTS，通常先升级到 22 线的安全补丁更可控；跨到 24 或 26 应另做兼容性评估。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;误区三：只看框架版本，不看 Node.js 运行时。&lt;/strong&gt; Express、NestJS、Next.js 等框架无法替代运行时漏洞修复。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;误区四：把 Permission Model 当成唯一沙箱。&lt;/strong&gt; 运行时权限限制应与容器、系统权限、网络隔离叠加使用。&lt;/p&gt;
&lt;h2 id="小结"&gt;&lt;a href="#%e5%b0%8f%e7%bb%93" class="header-anchor"&gt;&lt;/a&gt;小结
&lt;/h2&gt;&lt;p&gt;这次 Node.js 2026 年 6 月安全发布覆盖面广，重点不只是“升级一个小版本”，还涉及 TLS/mTLS、HTTP/2、WebCrypto、代理日志、权限模型等多个运行时边界。推荐的处理顺序是：先盘点所有 Node.js 运行时，再升级到 &lt;code&gt;v22.23.0&lt;/code&gt;、&lt;code&gt;v24.17.0&lt;/code&gt;、&lt;code&gt;v26.3.1&lt;/code&gt; 或包含修复的后续版本，最后用针对性回归测试确认关键路径稳定。&lt;/p&gt;
&lt;p&gt;对生产系统而言，安全补丁最怕“以为已经升级”。真正完成升级的标志不是配置文件改了，而是线上进程、容器镜像、CI 输出、监控指标都能证明新版本已经生效。&lt;/p&gt;</description></item></channel></rss>