使用PyQT时如何在自动完成仅显示一个选项时自动选中该选项？

可行性结论 #

这个需求在PyQt中完全可以实现，以下是两种常用的落地方案：

方案1：扩展内置QCompleter实现（改造成本最低） #

默认QCompleter本身提供了匹配统计的接口，只需要加少量自定义逻辑即可满足需求：

• 步骤1：将QCompleter绑定到你的输入框控件，设置补全模式为你需要的前缀匹配/模糊匹配
• 步骤2：绑定输入框的textChanged信号到自定义槽函数
• 步骤3：槽函数中每次文本更新后，调用completer.completionCount()获取当前匹配的候选项总数，当返回值为1时，直接选中唯一匹配项并完成补全。对应你举的示例，当用户输入「P」时，completionCount()就会返回1，逻辑触发后自动匹配「Potato」。

参考代码示例：

from PyQt5.QtWidgets import QLineEdit, QCompleter, QWidget, QVBoxLayout

class AutoCompleteLineEdit(QLineEdit):
    def __init__(self, options, parent=None):
        super().__init__(parent)
        self.completer = QCompleter(options, self)
        self.setCompleter(self.completer)
        self.textChanged.connect(self.auto_select_unique_match)

    def auto_select_unique_match(self, text):
        if not text:
            return
        # 统计当前匹配项数量
        match_count = self.completer.completionCount()
        if match_count == 1:
            # 选中唯一匹配项
            self.completer.setCurrentRow(0)
            # 获取匹配文本
            matched_text = self.completer.currentCompletion()
            # 可选方案1：直接填充到输入框，选中补全的后缀部分方便用户修改
            self.setText(matched_text)
            self.setSelection(len(text), len(matched_text))
            # 可选方案2：如果需要用户确认再填充，只弹出补全框自动选中第一项即可
            # self.completer.complete()

这种方案适配你现有代码的改造成本极低，不需要修改原有树形结构的数据源逻辑。

方案2：自定义匹配逻辑（适配复杂树形结构场景） #

如果你的补全数据源是动态从树形节点获取的，或者需要自定义匹配规则（比如支持中间子串匹配、优先级排序等），可以自己实现匹配逻辑：

• 每次输入文本更新时，遍历当前节点下的所有子选项，按照你的匹配规则筛选结果
• 当筛选结果长度为1时，直接把匹配到的选项文本填充到输入框即可
  这种方案灵活性更高，可以完全匹配你的树形导航场景的特殊需求。

补充优化点 #

你可以根据自己的交互需求调整逻辑：如果不需要自动填充，只需要自动选中补全列表的第一项，用户按回车直接确认即可，只需要保留上面代码里弹出补全框选中第一项的逻辑即可，无需自动填充文本。

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