比较修订

Thunderbird, Performance, Testing

如何创建 Thunderbird 性能概况并找到高 CPU 占用或卡顿的原因。

创建性能分析文件有助于开发人员查找 Thunderbird 中 CPU 负载过高、运行缓慢或内存占用问题的成因。但首先，请检查该问题在 [[[Troubleshoot Mode Thunderbird|Thunderbird 安全模式]] 下是否依然存在。您也可以参考 [https://wiki.mozilla.org/Thunderbird:Testing:Memory_Usage_Problems 性能排查清单] 进行逐步排查。 部分类型的性能分析需要使用开发版本，您可从 [https://www.thunderbird.net/download/daily/ Thunderbird 每日构建版] 获取。 我们将使用 Firefox 的性能分析工具，因此您可能会在分析器对话框中看到涉及 Firefox 的引用。[https://profiler.firefox.com/docs/#/ Firefox 性能分析器文档] 内容详实，但除非遇到问题或需要进行特殊分析（如启动性能分析），一般无需查阅该文档。请注意，文档中凡提及 ''Firefox'' 之处，均适用于 ''Thunderbird''。 {note}'''注意：'''在共享数据前，您有机会删除个人身份信息。{/note} __TOC__ = 第一步 - 记录 Thunderbird 的性能表现 = 性能记录器是 Thunderbird 中 ''开发者工具箱'' 的一部分。 在你开始记录之前，请就记录场景做充分的准备，以便测试 Thunderbird。 # 在 Thunderbird 主窗口中打开 ''开发者工具箱''：按 {for win,linux}{key Ctrl+Shift+I}{/for}{for mac}{key Command+Shift+I}{/for}，'''或'''点击 {menu ≡} > {menu 工具} > {menu 开发者工具}。 #; {warning}'''重要：'''在 ''传入连接...允许连接？'' 警告提示中点击 {key 确定}，否则工具箱无法连接到您的 Thunderbird 应用程序。<br><br>'''注意：'''该提示可能被其他 Thunderbird 窗口遮挡。{/warning} # 此时将显示 ''开发者工具'' 窗口。 # 当前版本的 Thunderbird 会显示 '''性能''' 标签页及 {button 开始录制} 按钮。若未显示该标签页，请按 {key F1} 或点击右上角的 {button •••} 按钮后选择 {menu 设置}，确保已勾选 {menu [✓] 性能} 选项。随后点击工具箱顶部出现的 {menu 性能} 标签页。 # 若出现 ''启动分析器时获取活动浏览器 ID 失败'' 提示可忽略。 # '''配置分析器设置：''' ## 点击开发者工具窗口底部的 '''编辑设置...''' ## 此时将显示 ''about:profiling'' 页面。 ## 选择 {button Thunderbird} 预设（若未默认选中）。此后任何设置更改都会使预设变为 ''自定义''（此为正常现象）。（若使用每日构建版，请选择 ''Daily'' 预设）。 ## 如有隐私顾虑或需节省内存，可取消勾选 {button 屏幕截图}。 ## 向下滚动并勾选 {button 所有文件 I/O}。 ## 根据需要调整其他设置，例如 {button 原生内存分配}（用于排查高内存占用问题）。（'''原生内存分配''' 功能需使用 Thunderbird 每日构建版）。 ## 若分析过程需超过 1 分钟，或启用了特定收集项，可能需要调整 '''缓冲区设置'''，例如将 '''缓冲区大小''' 从 1GB 增至 2GB，并将 '''采样间隔''' 从默认的 1 毫秒适当延长。 ## 直接关闭 ''about:profiling'' 页面即可（无 {button 确定} 或 {button 保存} 按钮）。 # 重要：开始性能录制前，请返回 Thunderbird 主窗口完成待分析场景的准备工作。 = 第二步 - 记录和保存性能概况 = 现在你可以开始记录性能了。非有特殊需求，记录要尽可能要短，只需记录导致问题的操作即可。 # 在 ''开发者工具'' 的 {menu 性能} 标签页，点击 {button 开始记录性能} 按钮。 # 紧接着，回到 Thunderbird 主窗口执行必要的操作。 # 完成后，马上到 ''开发者工具'' 窗口 {button 停止记录性能}。 = 第三步 - 保存与分享性能概况 = # 点击 {button 捕获记录} 完成收集过程，您将短暂看到 '''正在捕获配置文件'''，以 Firefox Profiler "https://profiler.firefox.com/from-browser/" 窗口结束。 如果您没有看到捕获按钮，则说明您使用的是旧版本的 Thunderbird 广告分析器。 跳到 [[#w_old-versions-of-thunderbird|Thunderbird 的旧版本]] 部分。 # 点击 {button 上传本地配置文件}。 在您准备共享的分析文件中，“包含可能可识别的附加数据”下方列有若干选项——请取消勾选您不希望共享的隐私信息项。 # 向下滚动以执行 {button 下载} 以保存本地 json 文件，或 {button 上传} 将配置文件发送到位于 https://profiler.firefox.com/ 的存储库。 '''上传''' 将以 https://share.firefox.dev/ 的形式提供一个永久链接，您可以复制它并与开发人员和其他可能帮助您解决问题的人分享。 # 关闭性能分析器窗口。 # 关闭开发者工具窗口。 == Thunderbird 的旧版本 == 旧版本的 Thunderbird 需要一些手动步骤来保存配置文件。 # 在左侧，在新的“Recording #1”项目旁边，单击“保存”链接并将文件保存到计算机上的某个位置。 文件扩展名必须是“.json”。 # 转到 https://profiler.firefox.com/ # 选择 {button 从文件加载配置文件} 并选择刚刚保存的“.json”文件以供上传。 # '''重要提示：在右上角附近，选择绿色的 {button 发布} 按钮'''，然后在 ''分享性能文件'' 面板中，再次选择（蓝色）{button 发布} 按钮。 # 复制在右上角新 {button 固定链接} 按钮下弹出的链接（例如 https://share.firefox.dev/1XYZXYz），并将其粘贴到适当的 [https://bugzilla.mozilla。 org/enter_bug.cgi?product=Thunderbird 新漏洞] 或 [https://bugzilla.mozilla.org Bugzilla (BMO)] 上的现有的漏洞。 # 最后，回到 ''开发者工具'' {menu 性能} 选项卡，您可以使用左上角配置文件列表上方的 '''垃圾图标''' 删除性能配置文件（您保存的位置 配置文件），然后关闭“开发者工具”窗口。 = 分析 Thunderbird 启动和关闭 = 分析启动或关闭请转到 [https://profiler.firefox.com/docs/#/./guide-startup-shutdown 特殊但简单的说明]。 同样，当提到“Firefox”时，相当于“Thunderbird”。