---
title: 文件 访问 性能分析器模块参考
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/profiler/visualizing-data/file-access-module
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/analysis/profiler/visualizing-data/file-access-module.md
last_updated: 2026-09-14
generated_at: 2026-11-16T14:58:49.073Z
locale: zh-cn
---

# 文件 访问 性能分析器模块参考

> 文件访问模块的引用，用于收集有关应用程序中文件 Activity 的数据。

文件 访问 性能分析器模块显示有关应用程序程序中的文件Activity的信息，例如 Unity 执行的读取或写入操作数量或Open的文件句柄数量。该模块可以显示指定的帧或捕获中All帧的信息。您可以使用此信息来确定应用程序执行文件操作的效率。

文件访问模块可以捕获已构建应用程序的 Folder 结构中的 ON Any 文件或 Unity Project Folder 中的文件操作信息（如果在 Unity Editor 中运行性能分析器）。此模块不会收集有关不成功文件操作的信息。如果文件操作尝试不成功，Unity 会显示报错。

默认情况下未已启用此模块。要启用文件访问性能分析器模块，请参阅[激活性能分析器模块](/engine/6000.0/manual/analysis/profiler/visualizing-data/modules-activate.md)。

## 图表类别##chart-categories

性能分析器窗口的上半部分显示具有以下类别的文件访问图表：

| **图表**        | **描述**                                            |
| ------------- | ------------------------------------------------- |
| **打开的文件**     | 此帧在本地文件System中成功打开的文件数量。                          |
| **文件已关闭**     | 此帧在本地文件System中成功关闭的文件数量。                          |
| **文件查找**      | 此帧在本地文件System中执行的文件查找操作的数量。文件查找操作涉及对文件内容的 search。 |
| **飞行中的读取**    | 此帧期间正在进行的读取操作的总计数量。                               |
| **文件句柄 Open** | 在此帧内时间Open的文件句柄数量。这包括 Unity 在同一帧中打开和关闭的文件。        |

## 模块细节面板工具栏##module-details-pane-toolbar

在 文件 访问 性能分析器模块中选择帧When，模块细节信息面板会显示 Unity 在捕获期间访问的文件的Detailed信息。使用工具栏访问以下功能：

| **属性**         | **描述**                                                                                                               |
| -------------- | -------------------------------------------------------------------------------------------------------------------- |
| **View 下拉**选单  | 使用Dropdown选单Change数据的View：**文件摘要**：显示 Unity 在选定帧期间访问的每个文件的 All 文件 Activity 的摘要。**访问权限**：按发生Order显示Data Set的每个文件访问操作。 |
| **帧 Dropdown** | 使用Dropdown选单选择要显示文件信息的帧：**此帧**：显示选定帧的文件 Activity 摘要。**All 帧**：显示性能分析器捕获中All有帧的文件Activity摘要。                          |
| **分析标记**       | 此模块不会自动填充细节面板。选择 Analysis Markers 按钮可使用数据填充细节面板。                                                                     |

## 文件 Summary View图##file-summary-view

文件 Summary View显示捕获期间每个文件发生的All文件访问操作的摘要。表的一个条目表示单一个文件的完整摘要。

表描述了 文件 Summary View表可以显示的All可能统计信息。默认情况下不会已启用All统计信息列。要Enable或禁用柱状图，请右键单击包柱状图标题的行的任何位置以Open菜单。使用菜单可Enable或禁用柱状图的View。

| **值**              | **描述**                                  |
| ------------------ | --------------------------------------- |
| **文件名**            | 访问的文件的 Name。                            |
| **读取的总计字节**        | Unity 在所选定帧期间从此文件读取的信息的总计数量。            |
| **读取访问时间 (ms)**    | Unity 在选定帧期间执行对此文件的读取所花费的总计时间。          |
| **访问数量**           | 在选定帧内对此文件的Any类型的访问数量。                   |
| **第一帧**            | Unity 访问此文件的第一帧 ON。                     |
| **帧数量**            | ON Unity 访问此文件的帧的总计数量。                  |
| **ID**             | 一个索引，表示文件访问Markers的执行Order。             |
| **读取带宽 (MBps)**    | ON 文件在选定帧上的读取操作的平均带宽（以 MB/秒为单位）。        |
| **Open 数量**        | 在选定帧期间对此文件进行的打开操作的总计数量。                 |
| **关闭数量**           | 在选定帧期间对此文件的关闭操作的总计数量。                   |
| **读取数量**           | 在选定帧期间对此文件的读取操作的总计数量。                   |
| **写入数量**           | 在选定帧期间对此文件的写入操作的总计数量。                   |
| **查找数量**           | 在选定帧期间对此文件执行的文件查找操作的总计数量。               |
| **写入的总计字节**        | Unity 在选定帧期间写入此文件的字节数量。                 |
| **写入带宽 (MBps)**    | ON 文件在选定帧上的写入操作的平均带宽（以 MB/秒为单位）。        |
| **Open 访问时间 (ms)** | Unity 在选定帧内对此文件执行打开操作所花费的总计时间（以毫秒为单位）。  |
| **关闭访问时间 (ms)**    | Unity 在选定帧内对此文件执行关闭操作所花费的总计时间（以毫秒为单位）。  |
| **写入访问时间 (ms)**    | Unity 在选定帧内执行对此文件的写入操作所花费的总计时间（以毫秒为单位）。 |
| **总计访问时间（毫秒）**     | Unity 在选定帧期间访问该文件花费的总计时间（以毫秒为单位）。       |

## Accesses View图##accesses-view

Accesses View 提供有关捕获中每个文件访问操作的 Detailed 信息。性能分析器 的细节信息面板中的表的每个条目都表示对单一个文件的单一个文件访问操作。表描述了 Accesses View可以显示的All可能列。

| **值**            | **描述**                                        |
| ---------------- | --------------------------------------------- |
| **Index**        | 一个 id 数量，表示 Unity 执行访问操作的Order。               |
| **文件名**          | 此操作期间访问的文件的 Name。要完整View文件路径，请将光标悬停在文件Name条目。 |
| **Type（类型）**     | 执行的访问操作的类型。这可以是 Open、关闭、Seek、Read 或 Write。    |
| **访问大小**         | 在访问期间传输的字节数量，其中访问为读取或写入。如果访问是文件查找，则大小为目标偏移。   |
| **偏移**           | 文件访问的（起始）偏移。                                  |
| **Duration（毫秒）** | 执行此访问所用的时间（以毫秒为单位）。                           |
| **平均带宽 (MBps)**  | 此访问的平均带宽，其中访问类型为读取。                           |
| **第一帧索引**        | 此访问开始 ON 的帧的 ID。                              |
| **帧**            | 进行此访问的帧的总计数量。                                 |
| **线程**           | ON 发生访问的线程。                                   |
| **时间戳 (ms)**     | 此访问开始的时间，相对于性能分析器捕获的 Start。                   |

## 上下文菜单##context-menu

右键单击 Any 文件访问 Markers 以打开包含 Additional Options 的子菜单以探索数据。可用选项如下：

| **值**                     | **描述**                                                                                         |
| ------------------------- | ---------------------------------------------------------------------------------------------- |
| **在 Timeline View 中显示标记** | 在 [CPU 使用率性能分析器](/engine/6000.0/manual/analysis/profiler/visualizing-data/cpu/cpu.md)模块中打开此标记。 |
| **转到此标记的第一帧**             | 选择标记首次出现在图表中的帧。如果标记仅出现在一帧上，则禁用此选项。                                                             |
| **转到此标记的最后一帧**            | 选择此标记上次在图表中显示的帧。如果标记仅出现在一帧上，则禁用此选项。                                                            |
| **按此文件路径过滤 View**         | 使用 **Filename** 柱状图的内容填充 search 栏以过滤结果。                                                        |

## 其他资源##additional-resources

* [性能分析器模块简介](/engine/6000.0/manual/analysis/profiler/visualizing-data/modules-introduction.md)
* [性能分析器窗口参考](/engine/6000.0/manual/analysis/profiler/window.md)
* [收集性能数据简介](/engine/6000.0/manual/analysis/profiler/profiling-applications/profiling-collect-data-introduction.md)
