Electron深链为何macOS能用Windows却失效？

同一套Electron代码，在macOS上点击自定义协议链接能唤起应用并正常跳转，部署到Windows后却毫无反应——这是许多跨平台桌面开发者踩过的坑。问题不在于协议注册代码写错了，而在于操作系统投递URL的机制根本不同。

两个平台，两种投递模型

据原文分析，macOS与Windows/Linux在深链处理上采用了截然不同的策略。

macOS把自定义scheme的URL直接交给已经运行的应用实例，由系统负责将事件传递到应用内部。这意味着开发者只需在主进程中监听相应事件，即可拿到URL并做路由处理。

Windows与Linux则没有这种"转交"机制。系统会启动应用的第二个副本，并把URL塞进该进程的命令行参数里。于是出现一个典型现象：用户点击链接后，任务管理器里多了一个Electron进程，但原有窗口没有任何变化——新实例可能因为单实例锁直接退出，URL也随之丢失。

两者的根本差异可以概括为：macOS是"事件投递"，Windows/Linux是"进程参数投递"。

自定义协议（Custom URL Scheme） 是操作系统级别的一种机制：应用在安装或首次运行时向系统注册一个形如 myapp:// 的标识，此后任何程序（浏览器、邮件客户端、其他应用）打开该前缀的链接，系统都会查找对应注册项并唤起目标应用。注册信息在 macOS 上写入 LaunchServices 数据库（通常由 Info.plist 中的 CFBundleURLTypes 声明），在 Windows 上则写入注册表 HKEY_CLASSES_ROOT（安装器负责写入）。正因注册与唤起都由操作系统托管，跨平台差异才不体现在代码 API 上，而体现在系统如何唤起应用、以及把 URL 放在哪个位置交给应用。

单实例锁（Single Instance Lock） 是 Electron 提供的进程级互斥机制。调用 app.requestSingleInstanceLock() 时，首个进程获得锁并继续运行；后续进程申请失败，会立即退出，同时向持锁进程触发 second-instance 事件。该事件的回调携带第二个进程的命令行参数与工作目录，因此它天然成为 Windows/Linux 上接收深链 URL 的通道。若未申请锁，每个副本都独立存活，事件不会触发，URL 就滞留在那个随即被用户忽略的新进程里。

主进程需要写两套处理逻辑

原文给出的方案是在主进程中针对两类平台分别实现。

对于macOS，核心是监听应用级别的open-url事件，在回调中解析传入的URL并执行导航或业务分发。这一路径的前提是应用已经运行，且系统把事件准确送达。

对于Windows与Linux，关键在于单实例锁与second-instance事件的配合。应用启动时先申请单实例锁；当第二个实例带着URL参数启动时，它会被检测到并触发second-instance事件，原实例在事件回调中读取命令行参数、提取URL，再把已有窗口聚焦到前台并完成跳转。

如果缺少单实例锁，第二个实例会独立运行，URL虽然被新进程拿到，但用户看到的仍是旧窗口，体验上等同于"深链失效"。

为什么这个差异容易被忽视

开发阶段在macOS上验证通过，很容易让人误以为深链功能已经完成。而Windows上的问题往往要到打包分发、真实用户点击链接时才暴露。

另一个隐蔽点在于参数解析：Windows下URL位于命令行参数数组中，需要正确识别其位置，不能简单取固定下标；不同启动方式（如通过浏览器、通过快捷方式）传入的参数结构可能不一致。原文强调按平台分支处理，正是为了避免这种"看起来一样、实际不一样"的陷阱。

命令行参数结构并不像表面看起来那样稳定。在 Windows 上，process.argv 的前几项依启动方式而变化：直接双击 exe、通过注册表协议唤起、经由打包工具（如 Squirrel）启动，前置参数的数量与内容都可能不同；带空格的 URL、含中文或百分号编码的 URL 还可能被引号包裹或拆分。稳妥的做法不是硬编码下标，而是从参数数组中筛选出符合 scheme:// 形式的那一项，或改用 app.isPackaged 判断后自尾部解析。相比之下，macOS 的 open-url 事件直接给出完整 URL 字符串，不存在这一层解析负担，这也是差异容易被忽视的技术原因之一。

工程实践建议

把深链处理抽象成独立模块，按平台注册不同的监听器，是更稳妥的做法。macOS侧走事件监听，Windows/Linux侧走单实例锁加参数解析，两条路径最终汇聚到同一个URL路由函数，避免业务逻辑重复。

同时在开发阶段就要在Windows环境验证深链，而不是等到发布后由用户反馈才发现问题。对于需要覆盖Linux的团队，也应把Linux归入"第二实例+参数"这一模型处理，而非套用macOS的事件思路。

常见问题

Q：为什么Windows上点击深链后没有反应？ A：因为系统启动了第二个实例，而原实例没有处理second-instance事件，URL未被传递到已有窗口。

Q：macOS需要单实例锁吗？ A：深链投递本身依赖事件机制，但若应用不希望多开，单实例锁仍是独立的设计考量。

Q：Linux的行为和Windows一致吗？ A：据原文，Linux与Windows同属"启动第二副本并传参"的模型，处理思路一致。