用 Arch Linux 装 GNOME 扩展时，页面上开关一拨，直接弹出一个让人摸不着头脑的英文报错：No such native application org.gnome.chrome_gnome_shell。我第一次碰到时一度以为 GNOME Shell 崩了，后来才发现，这句报错并不是在说 GNOME 本身有问题，而是从浏览器到 GNOME Shell 之间少了一座“桥”。这篇文章就专门把这个报错讲透：它到底是什么、为什么会出现在 Arch 上、怎么一次性装好、以及装完之后该怎么验证。
这个问题主要会出现在用 Firefox、Chromium 访问 GNOME Shell 扩展网站、尝试安装或开关扩展的用户身上，尤其是刚装好 Arch、只装了基础桌面没装额外连接组件的朋友。解决方案很简单：安装gnome-browser-connector这个包，但真正的坑藏在“装完之后”的判断上。
1. 问题定位：No such native application到底在说什么
1.1 这条报错的完整通信链路
GNOME 扩展网站extensions.gnome.org本身只是一个网页，网页里的 JavaScript 没有权限去访问你系统里的 GNOME Shell。浏览器想要读取你当前装了什么扩展、哪个开关没开，必须通过一个“中间层”来和本机通信。
这个中间层在浏览器里叫“原生消息宿主”（native messaging host），在系统里则是一个可执行程序 + 一个 JSON manifest 文件。网页里的 GNOME Shell Integration 扩展会告诉浏览器：我要找名叫org.gnome.chrome_gnome_shell的原生应用，浏览器就去固定目录里找对应的 JSON 文件，再根据 JSON 里的path字段启动真正的连接程序。
No such native application org.gnome.chrome_gnome_shell这句话的准确含义就是：浏览器在你的系统里搜遍了 native messaging host 的目录，却找不到一个名字能对得上org.gnome.chrome_gnome_shell的 manifest 文件。于是网页和 GNOME Shell 之间的通信断在了第一环，扩展开关自然也就没法用了。
这个报错里最让人困惑的是那串很长的 IDorg.gnome.chrome_gnome_shell。它看起来像一个应用包名，但实际它并不是一个 GNOME 软件的名称，而是浏览器扩展内部约定好的“协议名称”。这个名称从老项目chrome-gnome-shell一直沿用下来，哪怕现在的实现已经改成了gnome-browser-connector，名字也没变。所以看到它别慌，跟 Chromium 浏览器、Chrome 浏览器没有直接绑定关系，只是“原生消息”的查找 Key 而已。
1.2 为什么在 Arch Linux 上特别常见
这个问题不是 Arch 独有，但在 Arch 上出现的概率很高，原因主要有两个：
第一个原因是 Arch 的安装粒度很细。基础 GNOME 桌面里不会把浏览器连接器当成必装组件一起带进来。你以为装了 GNOME 就能装扩展，实际上 GNOME 的扩展管理界面（比如gnome-extensions-app、扩展网站）和“浏览器连接器”是两套东西，后者会默认被跳过。
第二个原因是 Arch 是滚动发行版，GNOME 主程序、浏览器、扩展插件的更新节奏完全不一样。很多时候你只是把 GNOME 从 44 升到 45，浏览器连接器却没有被自动跟随装上；或者你换了浏览器，忘了给新浏览器同步安装浏览器端的 Integration 插件，也会出现同样的报错。
一句话总结：报错不是“GNOME 坏了”，而是“浏览器到 GNOME 的中间程序丢了”。解决思路非常简单，安装连接器并确保浏览器端插件在同一个“通信握手”里被找到。
2. 正确解法：Arch 上装对那个包
2.1 首选方案：安装gnome-browser-connector
现在 Arch 官方软件源里对应的包名是gnome-browser-connector。直接安装：
sudo pacman -S gnome-browser-connector装完以后，这个包会在系统里完成三件事：放好org.gnome.chrome_gnome_shell的 native messaging manifest、提供连接用的可执行程序、以及向 GNOME Shell 的 D-Bus 服务注册相关接口。
这一步是解决报错的核心。只要这个包已经安装，浏览器再去找org.gnome.chrome_gnome_shell这个原生应用时，就能找到对应的 manifest 文件，错误基本就消失了一多半。
注意：如果你以前安装的是老包
chrome-gnome-shell，建议先把它完全卸载，再装gnome-browser-connector。两者功能重复，混着装容易因为 manifest 路径不一致出现“明明文件在，浏览器就是找不到”的怪问题。
2.2 浏览器端也要同步做的事
光装系统包不算完，浏览器端的 GNOME Shell Integration 插件同样必不可少。Firefox 对应的是 Add-on 里的“GNOME Shell integration”，Chromium 系浏览器对应扩展商店里的同名插件。名字不同没关系，认准就能装。
装好之后，在浏览器工具栏会出现一个 GNOME 图标。它和系统里的gnome-browser-connector通过原生消息握手。如果插件装好了，但系统包缺失，浏览器控制台会报当前这个错；反过来系统包装好了但没装浏览器插件，扩展网站上的开关会一直转圈或提示“无法与原生连接器通信”。
所以标准组合是：
- 系统层：
gnome-browser-connector - 浏览器层：GNOME Shell integration 扩展
两边缺一个，表现可能不完全一样，但最终都是“网页与 GNOME Shell 失联”。
2.3 旧包chrome-gnome-shell的坑
在 Arch 的 AUR 和部分老教程里，你还能搜到一个叫chrome-gnome-shell的包。它本身不是错，只是项目早就迁移并改名成gnome-browser-connector了。老包在新版 GNOME Shell 上可能还带着旧版 D-Bus 接口，或者 manifest 写的是旧路径，导致扩展网站能连上但安装扩展时拉到一半就失败。
我的建议是别在 2025 年还去 AUR 翻老包。优先用官方源的gnome-browser-connector，官方包会跟随 GNOME 版本滚动更新，至少不会出现“连接器还是 3.x 时代的老代码”这种问题。
如果你已经装了chrome-gnome-shell，想换成新包，可以这么操作：
# 如果是从 pacman 官方源装的（一般不会是） sudo pacman -Rs chrome-gnome-shell # 如果是从 AUR 装的，比如用 yay yay -Rs chrome-gnome-shell然后重新安装gnome-browser-connector，保险起见把浏览器也完全退出重开。
3. 完整实操流程：从装包到验证
3.1 安装前先确认当前状态
动手之前先看一眼自己到底缺哪一层，避免装完发现压根不是这个原因。
先确认 GNOME 版本：
gnome-shell --version比如输出GNOME Shell 45.x，那就对应最新的扩展生态。接着看连接器包是否存在：
pacman -Q gnome-browser-connector如果提示未安装，说明系统层缺失，问题基本上就定位在这里了。
再打开浏览器，看看工具栏有没有 GNOME 的图标。如果没有，浏览器插件大概率也没装。此时不要急着去扩展网站拨开关，先把两层都补齐，一步步来。
3.2 安装并核对 manifest 文件
执行：
sudo pacman -S gnome-browser-connector装完以后，可以用一条命令确认原生消息 manifest 是否到位：
pacman -Ql gnome-browser-connector | grep -i native-messaging正常会看到类似这样的输出：
/usr/lib/mozilla/native-messaging-hosts/org.gnome.chrome_gnome_shell.json /usr/lib/chromium/native-messaging-hosts/org.gnome.chrome_gnome_shell.json这两个文件就是浏览器查找org.gnome.chrome_gnome_shell时的“钥匙”。Firefox 会去mozilla目录找，Chromium 系浏览器会去chromium目录找。看到它们存在，核心问题就已经解决了。
如果某一条缺失，可以先sudo pacman -S --force gnome-browser-connector强制重装一次，检查是不是硬盘文件写入被覆盖或中途出问题。极少数情况下还要更新系统后再装：
sudo pacman -Syu sudo pacman -S gnome-browser-connector3.3 重启浏览器、重新打开扩展页面
包装好之后，一定要把浏览器完全退出再重进，而不是简单刷新页面。原生消息连接的建立是在浏览器启动时期检测的，重开才能让它重新扫描系统里的 native messaging host。
重开浏览器后，再访问extensions.gnome.org，此时页面顶部会提示“GNOME Shell Integration 扩展可用”。点开某个扩展的开关，网页会弹出确认安装的提示，这时不会再有No such native application报错。
如果之前已经因为这个错误点了很多次开关，页面状态可能卡住，清一下该网站缓存或者直接刷新一次即可。如果 GNOME Shell 这边始终没反应，可以退出登录 GNOME 会话再重新登录。在 X11 下按Alt+F2输入r能重载，但 Wayland 会话不支持这个快捷键，直接注销重进更可靠。
验证连接正常的最直观表现是：扩展网站首页能列出你系统上当前已安装的所有扩展，并且开关状态和 GNOME 实际情况一致。能看到这个列表，说明网页 → 浏览器插件 → 原生连接器 → GNOME Shell 整条链路已经通了。
4. 高频问题与排查技巧实录
4.1 常见的坑速查表
我在折腾这个问题的过程中，遇到过不少看起来一样、但细节完全不同的场景。下面这张表可以帮你快速对照：
| 现象 | 原因 | 解决办法 |
|---|---|---|
网页弹No such native application org.gnome.chrome_gnome_shell | 系统层连接器未安装 | sudo pacman -S gnome-browser-connector |
| 网页显示“无法与原生连接器通信” | 浏览器端 Integration 插件没装 | 安装浏览器扩展，并重启浏览器 |
| 装了连接器，网页仍报同样错误 | 浏览器没有完全重启 | 退出浏览器再打开，确认 manifest 目录存在 |
| 扩展列表能出来，但开关点了没反应 | GNOME Shell 版本与扩展不兼容 | 到 GNOME Shell 版本页查看扩展支持版本 |
| 用 Chromium 却找不到 manifest | 只装了 Firefox 版连接器包或版本太旧 | 更新gnome-browser-connector，确认 Chromium 路径有 JSON |
| 从 AUR 卸载老包后扩展页仍异常 | D-Bus 或缓存残留 | 注销重登一次，必要时重装浏览器插件 |
碰到报错先不要乱卸载 GNOME。很多人一看到这个错误以为是 GNOME 扩展系统出毛病，结果sudo pacman -S gnome重来一遍，劳民伤财，问题依旧。其实是连接器没装而已。
4.2 我的排错心得
这类“网页 ↔ 本地程序”的桥接问题，在 Linux 上其实很有代表性。它并不像“缺什么底层库”那么直观，因为表面报错来自浏览器，但真正缺失的却是一个系统包。
我在排查时最常用的一条命令是：
find /usr -name "org.gnome.chrome_gnome_shell.json" 2>/dev/null如果输出为空，那就不用再怀疑浏览器插件了，先去装系统连接器包；如果文件存在但还是报错，再去看浏览器插件的启用状态。这条“先系统层、后浏览器层”的排查顺序，能避免一大半无效操作。
还有一个小技巧：如果你不想通过网页安装扩展，可以直接用命令行安装本地 GNOME 扩展。把从网上找来的扩展.zip包下载到本地，用：
gnome-extensions install ~/Downloads/extension.zip然后注销重登或重载 GNOME Shell，扩展就会出现在已安装列表里。这条路完全绕开网页和浏览器连接器，适合在应急情况下用。但它无法解决网页开关的显示问题，如果你还想在扩展网站上统一管理，还是得把gnome-browser-connector装好。
说到底，No such native application org.gnome.chrome_gnome_shell这个报错就是 Arch“轻安装”传统的一个典型注脚：只装看起来必要的东西，往往会漏掉藏在浏览器和桌面之间的隐性依赖。把gnome-browser-connector装上，重启浏览器，问题就结束了。以后再遇到类似的原生消息连接报错，都可以先想想“中间那层程序到底装没装”。
