代码补全

版本

用法🔗

默认情况下，当用户编辑源代码或标记时，Sublime Text 会自动显示代码补全弹出窗口，但在注释、字符串或标记中的散文内不会显示。

按 Esc 键将隐藏代码补全弹出窗口。要手动显示代码补全弹出窗口，请按 Ctrl+空格。 如果没有可用的代码补全，状态栏中将显示消息 无可用代码补全。

自定义🔗

有许多方法可以使用新的代码补全来增强引擎的功能：

• 补全文件

• 代码片段

• 插件

{
    "scope": "source.python",
    "completions": [
        "def",
        "class",
        "None",
        "True",
        "False"
    ]
}

{
    "scope": "source.python",
    "completions": [
        {
            "trigger": "def",
            "contents": "def",
            "kind": "keyword"
        },
        {
            "trigger": "fun",
            "annotation": "basic function",
            "contents": "def ${1:name}($2):\n    $0\n",
            "kind": "snippet",
            "details": "A simple, non-<code>async</code> function definition"
        }
    ]
}

<snippet>
    <scope>source.python</scope>
    <tabTrigger>fun</tabTrigger>
    <content><![CDATA[def ${1:name}($2):
    ${0:pass}]]></content>
    <description>function, non-async</description>
</snippet>

Name: $1
Email: $2
Description: $0

Name: ${1:first} ${2:last}
Email: ${3:user}@${4:example.com}

Name: ${1:first} ${2:last}
Email: ${3:$1}@${4:example.com}

Name: ${1:name}
Email: ${2:${1/\s.*//}}@${3:example.com}

import sublime
import sublime_plugin


class MyCompletions(sublime_plugin.EventListener):
    def on_query_completions(self, view, prefix, locations):
        if not view.match_selector(locations[0], "source.python"):
            return []

        available_completions = [
            "def",
            "class",
            "None",
            "True",
            "False"
        ]

        prefix = prefix.lower()

        out = []
        for comp in available_completions:
            if comp.lower().startswith(prefix):
                out.append(comp)

        return out

设置🔗

"tab_completion" 布尔值🔗

启用后，按 Tab 键将插入最佳匹配的补全。禁用后，Tab 键将仅触发代码片段或插入制表符。启用 tab_completion 后，可以使用 Shift+Tab 插入显式制表符。

禁用此设置不会隐式禁用 auto_complete。

"auto_complete" 布尔值🔗

键入时自动显示补全弹出窗口。

此行为不受设置 tab_completion 的影响。

"auto_complete_size_limit" 整数🔗

如果当前文件的字节大小大于此值，则不会自动显示补全弹出窗口。

"auto_complete_delay" 整数🔗

自动显示补全弹出窗口之前的等待时间（以毫秒为单位）。

"auto_complete_selector" 字符串🔗

选择器，用于限制自动显示补全弹出窗口的时间。

示例： "meta.tag, source - comment - string.quoted.double.block - string.quoted.single.block - string.unquoted.heredoc"

"auto_complete_triggers" 设置可用于在特定情况下重新启用自动补全弹出窗口。

"auto_complete_triggers" 对象数组🔗

提供何时自动显示自动完成弹出窗口的显式触发器。

每个对象必须包含键 "selector"，其字符串值包含要与插入符号位置匹配的 选择器，以及一个 "characters" 键，其字符串值指定插入符号左侧必须存在的字符。

示例

[
    {
        "selector": "text.html",
        "characters": "<"
    }
]

触发器将覆盖设置 auto_complete_selector。

"auto_complete_commit_on_tab" 布尔值🔗

默认情况下，自动完成功能在按下 Enter 时提交当前完成的内容。此设置可用于使其在按下 Tab 时完成。

在 Tab 上完成通常是更好的选择，因为它消除了提交完成内容和插入换行符之间的歧义。

"auto_complete_with_fields" 布尔值🔗

控制在代码段字段处于活动状态时是否自动显示自动完成弹出窗口。仅在启用 auto_complete_commit_on_tab 时才相关。

"auto_complete_cycle" 布尔值🔗

控制在选中自动完成弹出窗口中的第一项时按下 ⬆ 会发生什么：如果为 false，则隐藏弹出窗口，否则选中弹出窗口中的最后一项完成内容。

还会导致在最后一项完成内容上按下 ⬇ 时选中第一项完成内容。

"auto_complete_use_history" 布尔值🔗

是否应自动选择以前选择的完成内容。

"auto_complete_include_snippets_when_typing" 布尔值🔗

.. since:: 4052

当此设置为 false 时，代码段不会出现在自动触发的完成弹出窗口中。如果手动触发，它们将显示。