启用完整水合
开启水合以避免重新渲染
启用完整水合 是 CoddyKit 上的免费 Angular Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Angular Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Angular Academy 课程共包含 4 节课。
启用水合
将 provideClientHydration() 添加到应用提供者中，即可启用完整水合。ng add @angular/ssr 原理图会为您自动添加它。
import { provideClientHydration } from '@angular/platform-browser';
export const appConfig = {
providers: [provideClientHydration()]
};添加位置
它应添加到浏览器端的 appConfig 提供者中，也就是用于引导客户端的同一个配置。服务器配置会通过 provideServerRendering() 在此基础上合并。
完整水合的含义
完整（急切）水合会在 JavaScript 加载并启动 Angular 后立即为整个组件树完成水合。每个组件都会立即变得可交互。
事件重放
启用 withEventReplay() 后，水合完成前发生的用户交互会被捕获，并在水合完成后重放，从而避免慢速设备上出现点击丢失。
import { provideClientHydration, withEventReplay } from '@angular/platform-browser';
providers: [provideClientHydration(withEventReplay())]HTTP 传输缓存
启用水合后，服务器返回的 HttpClient GET 响应默认会缓存到 TransferState 中，因此客户端启动后不会再次请求相同的数据。
provideClientHydration(withHttpTransferCacheOptions({ filter: r => r.method === 'GET' }))验证水合
在开发模式下打开控制台。Angular 会记录水合统计信息（已水合的组件数量、复用的节点数量）。如果没有不匹配警告，就表示水合已顺利完成。
// Angular hydrated 24 component(s) and 187 node(s)修复不匹配
如果看到 NG0500 不匹配错误，请查找非确定性的模板或手动修改 DOM 的代码。请使标记具有确定性，确保服务器和客户端的输出一致。
保护浏览器 API
在初始渲染期间操作 window 或 localStorage 的代码，可能会导致服务器和客户端之间的标记发生变化。请使用 isPlatformBrowser 进行保护，或在视图初始化后再运行。
if (isPlatformBrowser(this.platformId)) {
this.width = window.innerWidth;
}完整水合的权衡
完整水合实现简单，但会一开始就下载并执行所有组件的 JavaScript。对于大型应用，这可能会延迟交互能力，而增量水合正是为了解决这一问题。
国际化与水合
水合可以与 Angular i18n 一起使用，但请确保翻译后的内容具有确定性。服务器和客户端使用不一致的区域设置会导致水合错误。
生产检查
发布前，请构建生产版本，提供 SSR 输出，并在网络面板和控制台中确认水合运行时没有不匹配，同时传输缓存可以避免重复请求。
快速检查
检查您对完整水合的理解。
回顾
您使用 provideClientHydration() 启用了完整水合，添加 withEventReplay() 来处理水合前的点击，使用了 HTTP 传输缓存，保护了浏览器 API，并验证了水合过程没有问题。完整水合实现简单，但会一开始加载所有 JS。
常见问题解答
「启用完整水合」课时是免费的吗？
是的 — 「启用完整水合」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Angular Academy 课程的其余内容，请升级到 CoddyKit PRO。 Angular Academy 课程共包含 4 节课。
「启用完整水合」这节课中我会学到什么？
开启水合以避免重新渲染 你通过在浏览器中直接运行的动手代码来练习 Angular Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Angular Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Angular Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。
「启用完整水合」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Angular Academy 课中编写并运行代码吗？
能。每节 Angular Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。