如何配置IPython快捷键？添加自定义快捷键遇值错误求助

我尝试在IPython配置文件中添加以下配置：

c.TerminalInteractiveShell.shortcuts = [
    {
        "command": "IPython:auto_suggest.accept",
        "new_keys": ["c-z"],
    }
]

但IPython启动时报错：

ValueError: Multiple shortcuts matching {'command': 'IPython:auto_suggest.accept'} found, please add keys/filter to select one of: [Binding(command=<function accept at 0x7f6fc3aa4ca0>, keys=['c-f'], condition='has_suggestion & default_buffer_focused & emacs_like_insert_mode'), Binding(command=<function accept at 0x7f6fc3aa4ca0>, keys=['right'], condition='has_suggestion & default_buffer_focused & emacs_like_insert_mode')]

相关文档描述不清晰，找不到正确参考位置，请求解决该问题。

解决方案 #

报错核心原因是IPython:auto_suggest.accept命令已绑定多个快捷键（c-f和right），仅指定命令会让IPython无法确定要修改哪一组绑定。需通过精准定位绑定来解决：

方法1：通过原快捷键定位 #

在配置中加入keys字段，明确指定要修改的原快捷键，比如将c-f替换为c-z：

c.TerminalInteractiveShell.shortcuts = [
    {
        "command": "IPython:auto_suggest.accept",
        "keys": ["c-f"],  # 指定要修改的原快捷键
        "new_keys": ["c-z"],
    }
]

若要替换right快捷键，只需将keys值改为["right"]即可。

方法2：通过条件过滤定位 #

如果原快捷键可能变动，可通过filter字段匹配绑定的触发条件：

c.TerminalInteractiveShell.shortcuts = [
    {
        "command": "IPython:auto_suggest.accept",
        "filter": {"condition": "has_suggestion & default_buffer_focused & emacs_like_insert_mode"},
        "new_keys": ["c-z"],
    }
]

该方式会匹配所有符合条件的绑定，统一将它们的快捷键替换为c-z。

额外说明：新增快捷键而非替换 #

若想保留原快捷键，仅新增c-z作为触发方式，将new_keys替换为append_keys：

c.TerminalInteractiveShell.shortcuts = [
    {
        "command": "IPython:auto_suggest.accept",
        "keys": ["c-f"],
        "append_keys": ["c-z"],
    }
]

此时c-f和c-z均可触发自动补全接受命令。

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