rsc 是 react 生态定义的协议层,非 html 规范一部分;服务器生成 rsc payload(如 $1{...} 指令流),通过 multipart/mixed 响应传输,由客户端 react 运行时解析并构建 dom,html 仅作为最终宿主容器承载渲染结果。

HTML 本身不理解 RSC 原理——它压根不参与 RSC 的解析或执行。RSC(React Server Components)不是 HTML 规范的一部分,也不是浏览器原生支持的机制;它是一套由 React 生态定义、服务端生成、客户端运行时(如 Next.js 的 ReactClientRenderer)专门消费的协议层。
HTML 只负责承载 RSC 的最终输出结果
浏览器拿到的永远是 HTML(哪怕用了 RSC),而这个 HTML 是由服务端组件“渲染完成”后,经由流式 SSR 或 hydration 后注入的。RSC 的中间产物——比如 text/x-component 响应体、$ 开头的指令块、@ 引用模块——根本不会出现在最终的 HTML 源码里。它们在服务端就被转换成可序列化的 React 节点,再打包进 HTML 的 __NEXT_DATA__ script 标签,或通过流式 <script></script> 注入。
换句话说:
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图,自动匹配视觉风格。触发场景:文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
- 你右键查看网页源代码,看到的是纯 HTML,找不到任何
$1、@/components/UserCard这类 RSC 指令 -
标签本身没有新增属性或语义来标识“此处启用了 RSC” - HTML 解析器对 RSC payload 完全无感;它只按标准规范解析标签、属性、文本节点
RSC 的“原理”实际发生在 JS 运行时和 HTTP 响应头之间
真正体现 RSC 原理的地方,是服务端返回的响应头与响应体的配合,以及客户端 React 运行时如何解释它:
- 当请求路径带
/rsc/...后缀(如 Next.js 的 RSC Route Handler),服务端会设置Content-Type: multipart/mixed; boundary="rsc-xxx" - 响应体不是 HTML,而是多个以
--rsc-xxx分隔的 chunk,每个 chunk 包含类似$1{"id":"user-123"}的指令+JSON - 浏览器不会直接渲染这些 chunk;它们被
ReactClientRenderer拦截、解析、映射为虚拟 DOM 节点,并决定哪些该 hydrate、哪些该挂载为客户端组件 - HTML 文档只是这个过程的“宿主容器”,就像快递箱——里面装的是 RSC 解析后的 DOM 片段,但箱子本身不关心内容怎么拆包
为什么新手容易误以为 HTML “支持 RSC”
常见混淆点来自开发工具表象:
- 在 Chrome DevTools 的 Elements 面板里看到组件结构,就以为是 HTML 渲染出来的——其实是 React 在内存中构建并挂载的 DOM,HTML 源码里可能只有个空
<div id="root"></div> - 看到
data-rsc属性(如 Next.js 注入的data-rsc="1")就以为是 HTML 标准属性——它只是 React 运行时用于标记服务端渲染节点的私有标识,HTML 规范里没有定义 - 把
<suspense></suspense>当作 HTML 标签——它只是 React 提供的 JS 组件,浏览器根本不认识,靠 JSX 编译 + 运行时逻辑驱动
RSC 的核心复杂性不在 HTML 层,而在服务端如何构造流式指令、客户端如何增量解析并协同 hydration。一旦你开始调试 RSC,真正要盯住的是 Network 面板里的 /rsc/xxx 请求响应体格式,而不是 Elements 面板里的 HTML 结构。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










