63 lines
1.5 KiB
Markdown
63 lines
1.5 KiB
Markdown
# macOS 26 Tahoe 兼容性修复
|
||
|
||
## 问题描述
|
||
|
||
在 macOS 26 Tahoe 上，Electron 应用启动时崩溃：
|
||
|
||
```
|
||
Exception Type: EXC_BREAKPOINT (SIGTRAP)
|
||
Thread 0 Crashed:: Dispatch queue: com.apple.main-thread
|
||
0 Electron Framework cxxbridge1$box$rust_png$ResultOfReader$drop
|
||
1 Electron Framework ElectronMain + 84
|
||
```
|
||
|
||
## 根本原因
|
||
|
||
**macOS 26 Tahoe 上存在 Electron 兼容性问题：**
|
||
|
||
- **崩溃位置**: `ElectronMain` 初始化阶段
|
||
- **相关组件**: Chromium 的 Rust 组件（Fontations 字体后端、rust_png）
|
||
- **触发时机**: 崩溃发生在 **任何应用代码执行之前**
|
||
- **影响范围**: Electron 38+ 版本（Chrome 140+）
|
||
|
||
## 解决方案
|
||
|
||
在 `src/main/main.ts` 文件开头添加：
|
||
|
||
```typescript
|
||
import { app } from 'electron';
|
||
|
||
// macOS 26 Tahoe 兼容性：禁用 Fontations 字体后端
|
||
// 参考: https://github.com/electron/electron/issues/49522
|
||
if (process.platform === 'darwin') {
|
||
app.commandLine.appendSwitch('disable-features', 'FontationsFontBackend');
|
||
}
|
||
```
|
||
|
||
## 版本历史
|
||
|
||
| 版本 | 修复内容 |
|
||
|------|----------|
|
||
| 0.4.4 | 降级到 Electron 37 (临时方案) |
|
||
| **0.4.5** | 升级到 Electron 39 + 添加 workaround |
|
||
|
||
## 验证方法
|
||
|
||
打包后的应用进程参数中应包含：
|
||
|
||
```
|
||
--disable-features=FontationsFontBackend
|
||
```
|
||
|
||
```bash
|
||
ps aux | grep -i "Qiming Agent" | grep -v grep
|
||
```
|
||
|
||
## 参考资料
|
||
|
||
- [Electron Issue #49522](https://github.com/electron/electron/issues/49522)
|
||
|
||
---
|
||
|
||
*最后更新: 2026-02-25*
|