创建性能分析文件有助于开发人员查找 Thunderbird 中 CPU 负载过高、运行缓慢或内存占用问题的成因。但首先，请检查该问题在 Thunderbird 安全模式 下是否依然存在。您也可以参考 性能排查清单 进行逐步排查。

部分类型的性能分析需要使用开发版本，您可从 Thunderbird 每日构建版 获取。

我们将使用 Firefox 的性能分析工具，因此您可能会在分析器对话框中看到涉及 Firefox 的引用。Firefox 性能分析器文档 内容详实，但除非遇到问题或需要进行特殊分析（如启动性能分析），一般无需查阅该文档。请注意，文档中凡提及 Firefox 之处，均适用于 Thunderbird。

第一步 - 记录 Thunderbird 的性能表现

性能记录器是 Thunderbird 中 开发者工具箱 的一部分。

在你开始记录之前，请就记录场景做充分的准备，以便测试 Thunderbird。

1. 在 Thunderbird 主窗口中打开 开发者工具箱：按 Ctrl + Shift + ICommand + Shift + I，或点击 ≡ > 工具 > 开发者工具。

   重要：在 传入连接...允许连接？ 警告提示中点击 确定，否则工具箱无法连接到您的 Thunderbird 应用程序。
   
   注意：该提示可能被其他 Thunderbird 窗口遮挡。

2. 此时将显示 开发者工具 窗口。
3. 当前版本的 Thunderbird 会显示 性能 标签页及 开始录制 按钮。若未显示该标签页，请按 F1 或点击右上角的 ••• 按钮后选择 设置，确保已勾选 [✓] 性能 选项。随后点击工具箱顶部出现的 性能 标签页。
4. 若出现 启动分析器时获取活动浏览器 ID 失败 提示可忽略。
5. 配置分析器设置：
   1. 点击开发者工具窗口底部的 编辑设置...
   2. 此时将显示 about:profiling 页面。
   3. 选择 Thunderbird 预设（若未默认选中）。此后任何设置更改都会使预设变为 自定义（此为正常现象）。（若使用每日构建版，请选择 Daily 预设）。
   4. 如有隐私顾虑或需节省内存，可取消勾选 屏幕截图。
   5. 向下滚动并勾选 所有文件 I/O。
   6. 根据需要调整其他设置，例如 原生内存分配（用于排查高内存占用问题）。（原生内存分配 功能需使用 Thunderbird 每日构建版）。
   7. 若分析过程需超过 1 分钟，或启用了特定收集项，可能需要调整 缓冲区设置，例如将 缓冲区大小 从 1GB 增至 2GB，并将 采样间隔 从默认的 1 毫秒适当延长。
   8. 直接关闭 about:profiling 页面即可（无 确定 或 保存 按钮）。
6. 重要：开始性能录制前，请返回 Thunderbird 主窗口完成待分析场景的准备工作。

第二步 - 记录和保存性能概况

现在你可以开始记录性能了。非有特殊需求，记录要尽可能要短，只需记录导致问题的操作即可。

1. 在 开发者工具 的 性能 标签页，点击 开始记录性能 按钮。
2. 紧接着，回到 Thunderbird 主窗口执行必要的操作。
3. 完成后，马上到 开发者工具 窗口 停止记录性能。

第三步 - 保存与分享性能概况

1. 点击 捕获记录 完成收集过程，您将短暂看到 正在捕获配置文件，以 Firefox Profiler "https://profiler.firefox.com/from-browser/" 窗口结束。 如果您没有看到捕获按钮，则说明您使用的是旧版本的 Thunderbird 广告分析器。 跳到 Thunderbird 的旧版本 部分。
2. 点击 上传本地配置文件。 在您准备共享的分析文件中，“包含可能可识别的附加数据”下方列有若干选项——请取消勾选您不希望共享的隐私信息项。
3. 向下滚动以执行 下载 以保存本地 json 文件，或 上传 将配置文件发送到位于 https://profiler.firefox.com/ 的存储库。 上传 将以 https://share.firefox.dev/ 的形式提供一个永久链接，您可以复制它并与开发人员和其他可能帮助您解决问题的人分享。
4. 关闭性能分析器窗口。
5. 关闭开发者工具窗口。

Thunderbird 的旧版本

旧版本的 Thunderbird 需要一些手动步骤来保存配置文件。

1. 在左侧，在新的“Recording #1”项目旁边，单击“保存”链接并将文件保存到计算机上的某个位置。 文件扩展名必须是“.json”。
2. 转到 https://profiler.firefox.com/
3. 选择 从文件加载配置文件 并选择刚刚保存的“.json”文件以供上传。
4. 重要提示：在右上角附近，选择绿色的 发布 按钮，然后在 分享性能文件 面板中，再次选择（蓝色）发布 按钮。
5. 复制在右上角新 固定链接 按钮下弹出的链接（例如 https://share.firefox.dev/1XYZXYz），并将其粘贴到适当的 org/enter_bug.cgi?product=Thunderbird 新漏洞 或 Bugzilla (BMO) 上的现有的漏洞。
6. 最后，回到 开发者工具 性能 选项卡，您可以使用左上角配置文件列表上方的 垃圾图标 删除性能配置文件（您保存的位置 配置文件），然后关闭“开发者工具”窗口。

分析 Thunderbird 启动和关闭

分析启动或关闭请转到 特殊但简单的说明。 同样，当提到“Firefox”时，相当于“Thunderbird”。