PyQt6连接linkActivated调用QDesktopServices.openUrl触发类型错误的解决方法

问题场景 #

尝试将linkActivated信号连接到lambda表达式，调用QDesktopServices.openUrl打开外部链接，代码如下：

self.lbl_supporting_text.linkActivated.connect(
    lambda link: QDesktopServices.openUrl(QUrl(link))
)

触发类型错误：

Error: Argument of type "(link: Any) -> bool" cannot be assigned to parameter "slot" of type "PYQT_SLOT" in function "connect"
  Type "(link: Any) -> bool" cannot be assigned to type "PYQT_SLOT"
    Type "(link: Any) -> bool" cannot be assigned to type "(...) -> None"
      Function return type "bool" is incompatible with type "None"
        Type cannot be assigned to type "None"
    "function" is incompatible with "pyqtBoundSignal"PylancereportGeneralTypeIssues

错误原因 #

PyQt要求信号绑定的槽函数返回值必须为None，但QDesktopServices.openUrl()会返回布尔值表示链接是否成功打开，lambda表达式直接返回了这个布尔值，导致类型不匹配。

解决方法 #

方法1：修改lambda使其返回None #

让lambda表达式在调用openUrl后返回None，可以用逻辑表达式或逗号表达式实现：

# 方式1：利用逻辑运算符返回None
self.lbl_supporting_text.linkActivated.connect(
    lambda link: QDesktopServices.openUrl(QUrl(link)) or None
)

# 方式2：用逗号表达式强制返回None
self.lbl_supporting_text.linkActivated.connect(
    lambda link: (QDesktopServices.openUrl(QUrl(link)), None)[1]
)

方法2：使用普通函数作为槽 #

定义单独的槽函数，内部调用openUrl且不返回值（默认返回None）：

def open_external_link(self, link):
    QDesktopServices.openUrl(QUrl(link))

# 连接信号与槽
self.lbl_supporting_text.linkActivated.connect(self.open_external_link)

方法3：使用functools.partial包装 #

通过functools.partial包装调用逻辑，确保返回值为None：

from functools import partial

def open_link(link):
    QDesktopServices.openUrl(QUrl(link))

self.lbl_supporting_text.linkActivated.connect(partial(open_link))

其他打开外部链接的方式 #

所有方案核心都是确保槽函数返回None，本质都是通过QDesktopServices.openUrl实现外部浏览器打开链接，上述三种方法已经覆盖了常用的实现方式。

内容的提问来源于stack exchange，提问作者monotype