调试 Web 应用性能
学习如何使用 Chrome DevTools 调试 Web 性能问题。
Flutter 框架在构建帧、绘制场景以及跟踪垃圾回收等活动时会发出 timeline 事件。这些事件会暴露在 Chrome DevTools performance panel(性能面板)中,供调试使用。
你还可以使用 dart:developer 的
Timeline
和 TimelineTask
API 发出自定义 timeline 事件,以进行更深入的性能分析。
用于增强跟踪的可选标志
#要在应用中配置跟踪哪些 timeline 事件,请在 main 方法中将以下任一顶层属性设为 true。
-
debugProfileBuildsEnabled: Adds
Timelineevents for everyWidgetbuilt. -
debugProfileBuildsEnabled:为每个已构建的
Widget添加Timeline事件。 -
debugProfileBuildsEnabledUserWidgets: Adds
Timelineevents for every user-createdWidgetbuilt. -
debugProfileBuildsEnabledUserWidgets:为每个用户创建的已构建
Widget添加Timeline事件。 -
debugProfileLayoutsEnabled: Adds
Timelineevents for everyRenderObjectlayout. -
debugProfileLayoutsEnabled:为每次
RenderObject布局添加Timeline事件。 -
debugProfilePaintsEnabled: Adds
Timelineevents for everyRenderObjectpainted. -
debugProfilePaintsEnabled:为每次
RenderObject绘制添加Timeline事件。
操作步骤
#[Optional] Set any desired tracing flags to true from your app's main method.
[可选] 在应用的
main方法中将所需的跟踪标志设为 true。Run your Flutter web app in profile mode.
以 profile mode(profile 模式)运行 Flutter Web 应用。
-
Open up the Chrome DevTools Performance panel for your application, and start recording to capture timeline events.
-
为应用打开 Chrome DevTools Performance panel(性能面板),并 start recording(开始录制)以捕获 timeline 事件。
除非另有说明,本文档之所提及适用于 Flutter 3.44.0 版本。本页面最后更新时间:2026-06-04。查看文档源码 或者 为本页面内容提出建议。