# @electron/symbolicate-mac 中文文档 规范地址：https://npmcn.com/package/%40electron/symbolicate-mac/ 版本：3\.0\.0 npm 元数据更新时间：2025-05-21T19:50:43.735Z 中文译文更新时间：2026-11-13T12:03:20.615Z 软件包许可：ISC 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40electron/symbolicate-mac 原文对照：https://npmcn.com/package/%40electron/symbolicate-mac/?lang=original 项目主页：https://github.com/electron/symbolicate-mac#readme 源码仓库：https://github.com/electron/symbolicate-mac ## 关键信息（来自 npm 元数据） - 包体积（解压后）：14.3 kB，5 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=22\.12\.0 - 运行依赖：1 个 - 首次发布：2019-06-14T22:30:53.545Z - 最新版本发布：2025-05-21T19:50:43.345Z - 近 30 天下载量：10933（2026-10-14 至 2026-11-12，npm 官方下载统计） - 已发布版本数：13（近 12 个月 0 个） ## 中文简介 符号文本 Electron macOS 崩溃 ## 安装 ```sh npm install @electron/symbolicate-mac ``` 也可以使用：`pnpm add @electron/symbolicate-mac`、`yarn add @electron/symbolicate-mac`、`bun add @electron/symbolicate-mac` ## README # @ electron/ symbolicate-mac (英语) [![Test](https://github.com/electron/symbolicate-mac/actions/workflows/test.yml/badge.svg)](https://github.com/electron/symbolicate-mac/actions/workflows/test.yml) [![npm version](http://img.shields.io/npm/v/@electron/symbolicate-mac.svg)](https://npmjs.org/package/@electron/symbolicate-mac) 符号a [电子](https://www.electronjs.org/) macOS 崩溃报告 缺少符号。 环绕 [解析板](https://github.com/nornagon/parse-breakpad) 与 方便地解析和下载符号文件. 此工具下载符号文件并存储在 `cache` 与模块相对的文件夹。 这些文件很大( ~ 400MB) , 可能 初始下载需要一些时间. ``` $ npx @electron/symbolicate-mac /path/to/crash ``` 注意崩溃文件必须是 _满_ 坠毁,包括"Binary" 图像"部分, 否则象征-mac 将无法发现准确 要使用的Electron版本. ## 使用量 - 获取完整的坠毁堆放,取样报告,或自旋泵. ``` Process: Slack [2214] Path: /Applications/Slack.app/Contents/MacOS/Slack Identifier: com.tinyspeck.slackmacgap Thread 0 Crashed:: Dispatch queue: com.apple.main-thread [...] 91 com.github.Electron.framework 0x000000010ae32a06 v8::internal::SetupIsolateDelegate::SetupHeap(v8::internal::Heap*) + 2919558 92 com.github.Electron.framework 0x000000010ae36119 v8::internal::SetupIsolateDelegate::SetupHeap(v8::internal::Heap*) + 2933657 [...] Binary Images: 0x109ae8000 - 0x109b37fcf +com.tinyspeck.slackmacgap (4.18.0 - 6748) /Applications/Slack.app/Contents/MacOS/Slack 0x109b49000 - 0x1115c0f7f +com.github.Electron.framework (13.1.6) <36C7F681-FAD6-3CD1-B327-6C1054C359C7> /Applications/Slack.app/Contents/Frameworks/Electron Framework.framework/Versions/A/Electron Framework [...] ``` - 运行 `@electron/symbolicate-mac` 并指定文件的路径 ```sh npx @electron/symbolicate-mac /path/to/crash.txt ``` - 崩溃将被打印出来, 并解决符号: ``` [...] 91 com.github.Electron.framework 0x000000010ae32a06 content::BrowserMainLoop::EarlyInitialization() 92 com.github.Electron.framework 0x000000010ae36119 content::BrowserMainRunnerImpl::Initialize(content::MainFunctionParams const&) [...] ``` ## 常见问题 ### @electron/symbolicate-mac 是什么？ 符号文本 Electron macOS 崩溃 ### 如何安装 @electron/symbolicate-mac？ 在项目目录运行 npm install @electron/symbolicate-mac，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 electron-symbolicate-mac，可以用 npx electron-symbolicate-mac 直接运行。 ### @electron/symbolicate-mac 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/electron\_\_symbolicate-mac 是否存在。 ### @electron/symbolicate-mac 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @electron/symbolicate-mac 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22\.12\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @electron/symbolicate-mac 可以商用吗？ @electron/symbolicate-mac 使用 ISC 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @electron/symbolicate-mac 的下载量有多少？ 根据 npm 官方下载统计，@electron/symbolicate-mac 在 2026/10/14 – 2026/11/12 这 30 天内被下载 10,933 次，日均约 364 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @electron/symbolicate-mac 还在维护吗？ 最新版本 3\.0\.0 发布于 2025/05/22（1\.5 年前）；至今共发布 13 个版本，其中过去 12 个月发布了 0 个；首次发布于 2019/06/15。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。