自动关联目录：Nanite

官方依据：Nanite Virtualized Geometry Overview（UE 5.8 Documentation）。本页覆盖该官方页的全部条目，并补上官方手册不写的代价、限制成因、CVar 与排查。

1. 定位

Nanite 是 UE 的虚拟化几何系统：用一套自有的网格格式与渲染技术，做到"像素级细节 + 极高物体数量"，并且只对屏幕上真正可见的细节做工作。

一句话定位：Nanite 把"三角形数量"从帧预算里拿掉了——代价是它自己独占一条渲染路径，因此有一长串"不支持"清单。

是否启用 Nanite 不是美术决定，是平台与特性决定：先看目标平台是否在支持列表里，再看你的材质/形变需求是否落在支持范围内。

2. 结构

数据是怎么组织的

导入时：
  源网格 → 分析并拆成"层级的三角形簇（hierarchical clusters）"
         → 高度压缩存储

运行时：
  按摄像机视图，在多个 LOD 层级间实时切换簇
  同一物体内相邻簇完美拼接（无缝）
  按需流式加载：只有可见细节驻留内存
  在自己的渲染 Pass 里跑，完全绕开传统 draw call

**因为它依赖从磁盘快速流式读取，官方明确建议使用 SSD 作为运行时存储。**这是很多"PC 上流畅、机械硬盘上卡"的直接原因。

与静态网格的关系

Nanite 网格本质仍是一个三角形网格，只是：

3. 收益（官方列出，附我的判断）

官方自己也提醒：实际限制仍然存在——实例数、单网格三角形数、材质复杂度、输出分辨率、性能，都要针对你的内容与硬件实测。

4. 该用在哪些网格上

通用原则：支持的平台上尽量都开，开了通常更快、更省内存与磁盘。

特别适合：

不适合（官方点名的例外）：天空球——三角形在屏幕上很大、不遮挡任何东西、场景里只有一个。官方也说这类例外很少，且性能损失很小，不必过度纠结"哪里不该开"。

5. 关键 API 与配置

启用方式（三种）

1. 导入时勾选 Build Nanite
2. 单个网格编辑器：Details → Nanite Settings → Enable Nanite Support
3. Content Browser 批量：选中多个 → 右键 → Nanite > Enable

可启用 Nanite 的组件类型：

转换每个网格都要处理时间，大项目里共享 DDC 非常重要（见 Cook 与打包流程）。

导入时的一个实际建议

不用 Lightmass 烘焙 GI 时，官方建议关闭 Generate Lightmap UVs：高细节几何会显著增加导入与构建时间，而且这会多出一套 UV 通道，对高密度网格是很大的数据量。

项目设置

Project Settings → Engine > Rendering → Nanite；各网格编辑器（静态/骨骼）的 Details 面板也有各自的 Nanite 设置。

6. 特性矩阵

7. 支持范围（这份清单是判断是否可用的第一依据）

几何

网格形变

材质

渲染（不支持清单）

编辑器里看高细节几何的法线/UV 视图模式要小心——一次性把全部数据显示在屏幕上会拖垮编辑器性能。

平台

当前主机与桌面平台，显卡需最新驱动 + DirectX 12 + Shader Model 6（SM6）。

8. 参数与控制台变量

注意：Nanite 的可视化模式（Nanite Visualization）是排查"为什么这个网格看起来是糊的"的第一工具——能看到三角形/簇的实际分布。

9. 代价与权衡

10. 踩坑与排查

11. 排查顺序

1. 平台是否支持？（DX12 + SM6）
2. 材质 Blend Mode 是否 Opaque/Masked？
3. 是否用了不支持的特性？（Morph、前向渲染、MSAA、VR、Lighting Channels）
4. 视觉异常 → Nanite Visualization 看簇与三角形
5. 性能问题 → profilegpu 看 Nanite Pass；确认存储在 SSD
6. 光追相关 → Fallback Mesh 精度与 r.RayTracing.Nanite.Mode

参考

• Nanite Virtualized Geometry Overview
• Nanite Technical Details
• Using Nanite with Landscapes
• Working with Nanite-Enabled Content