---
title: RenderDoc 集成
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/zh-cn/engine/6000.0/manual/analysis/graphics-performance-profiling/profiling/render-doc-integration
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/analysis/graphics-performance-profiling/profiling/render-doc-integration.md
last_updated: 2026-10-30
generated_at: 2026-11-20T21:17:57.415Z
locale: zh-cn
---

# RenderDoc 集成

> 使用 RenderDoc 调试器可以 ON 逐帧调试图形。

Editor 支持集成启动和捕获 [RenderDoc](https://github.com/baldurk/renderdoc) 图形调试器，以便进行详细的帧内省和调试。

仅 RenderDoc 0.26 或更高版本支持集成，因此如果当前安装了早期版本，则需要至少更新到 0.26 版本。

> **Note:**
>
> 虽然集成仅在 Editor 中可用，但完全可以像法线一样使用 RenderDoc，无需在独立平台播放器构建中进行额外设置。

> **Note:**
>
> 仅当 Unity ON RenderDoc 支持的平台和 API 上running时，才能捕帧。如果正在使用另一个 API，则会暂时Disabled RenderDoc 集成，直到已启用支持的 API。请参阅 [RenderDoc 文档](https://renderdoc.org/docs/getting_started/features.html#)以了解有关支持的平台和 API 的更多信息。

## 加载中 RenderDoc##loading-renderdoc

如果检测到 RenderDoc 安装，则在 Editor 加载后的 Any 时间，都可以右键单击 [Game View](/engine/6000.0/manual/unity-editor/editor-windows-views-reference/game-view.md) 或 [场景视图](/engine/6000.0/manual/unity-editor/editor-windows-views-reference/using-the-scene-view.md)的选项卡，然后单击“加载 RenderDoc”选项。这将重新加载图形设备，因此必须 Save Any 更改，但随后 RenderDoc 将准备好捕获，而无需重新启动 Editor 或独立平台播放器版本。

> **Note:**
>
> 您也可以通过 RenderDoc 正常启动 Editor，或通道 -load-renderdoc 命令行选项以在启动时加载 RenderDoc。

## 使用 RenderDoc 捕获帧##capturing-a-frame-with-renderdoc

当检测到兼容版本的 RenderDoc 已加载到 Editor 中时，工具栏右侧 ON Game 和 Scene 视图将显示新建按钮。


**Capturing a frame with RenderDoc:**
![](/api/media?file=/engine/6000.0/media/images/RenderDocCaptureButton.png)

按下此按钮触发器Viewew图的Next帧渲染。如果 RenderDoc 工具 UI 尚未打开，则会启动一个新建实例来显示捕获，如果已在running，则最新捕获将自动显示在此处。从此处可以使用 工具Open捕获和调试。


**List of frame captures in RenderDoc:**
![](/api/media?file=/engine/6000.0/media/images/RenderDocCaptureList.jpg)

## 包含着色器调试信息##including-shader-debug-information

默认情况下，为了优化 DirectX11 着色器的大小，会删除调试信息。这意味着常量和资源没有名称，着色音频源频源不可用。要在着色器中包含此调试信息，请在着色器的`HLSLPROGRAM`代码块中包含\*\*# pragma enable\_d3d11\_debug\_symbols\*\*。

## 替代图形调试技术##alternative-graphics-debugging-techniques

如果使用 D3D11 版本独立平台播放器，可以使用 [Visual Studio 图形调试器](/engine/6000.0/manual/materials-and-shaders/shaders/shader-troubleshooting/shader-debugging/sl-debugging-d3d11shaders-with-vs.md)捕获帧并进行调试。

## 在 RenderDoc 中配置 Android SDK##configuring-android-sdk-in-renderdoc

使用 RenderDoc 开发 Android Applications程序When，请确保使用以下方式之一正确配置 Android SDK：

### 将 RenderDoc 设置为与 Unity 使用相同的 SDK（推荐）##set-renderdoc-to-use-the-same-sdk-as-unity-(recommended)

1. 在 RenderDoc 窗口中，转到 **Tools** > **Settings** > **Android**。
2. 在 **Android SDK 根路径**下，进入 Unity 用于 Android SDK 的路径。可在 Unity Editor 的 **Edit** > **偏好**设置 > **Android SDK 工具**下查找此路径。

### 在 RenderDoc 和 Unity 之间对齐 ADB 版本和路径##align-adb-versions-and-paths-between-renderdoc-and-unity

如果未设置 RenderDoc Settings 中的 **Android SDK 根路径**，RenderDoc 将使用 `PATH` Environment 变量中为 ADB 设置的路径。

1. 查找 `PATH` 变量中设置的 ADB 路径。

   * Windows PowerShell：`Get-Command adb | Select-Object Path`
   * Windows 命令提示符：`where adb`

2. 在 Windows Terminal 中检查 ADB 版本：`C:\[adb path from command output]\adb.exe version`。

3. 查找 Unity 使用的 ADB 路径。在 Unity Editor 中，转到 **Edit** > **偏好**设置 > **Android SDK 工具**。

4. 在 Windows Terminal 中检查相应的 ADB 版本：`C:\[path to Android sdk platform-tools]\adb.exe version`。

5. 比较 RenderDoc 和 Unity 使用的 ADB 版本。如果不同，请选择其中一个 ADB 位置，并将两个工具配置为使用相同的路径。

> **Note:**
>
> 使用 Android Studio 中的 Android SDK 管理器，确保选定 SDK 中的平台工具是[最新的](https://developer.android.com/studio/intro/update)。
