Gopls: Подсказки вставки

Подсказки вставки — это полезные аннотации, которые редактор может дополнительно отображать прямо в исходном коде, например, имена параметров в вызове функции. В данном документе описываются подсказки вставки, доступные в gopls.

assignVariableTypes

"assignVariableTypes" управляет подсказками вставки для типов переменных в инструкциях присваивания:

<code class="language-go">    i/* int*/, j/* int*/ := 0, len(r)-1
</code>

По умолчанию отключено. Включите, установив "hints": {"assignVariableTypes": true}.

compositeLiteralFields

"compositeLiteralFields" подсказки вставки для имен полей составных литералов:

<code class="language-go">    {/*in: */"Hello, world", /*want: */"dlrow ,olleH"}
</code>

По умолчанию отключено. Включите, установив "hints": {"compositeLiteralFields": true}.

compositeLiteralTypes

"compositeLiteralTypes" управляет подсказками вставки для типов составных литералов:

<code class="language-go">    for _, c := range []struct {
  in, want string
}{
  /*struct{ in string; want string }*/{"Hello, world", "dlrow ,olleH"},
}
</code>

По умолчанию отключено. Включите, установив "hints": {"compositeLiteralTypes": true}.

constantValues

"constantValues" управляет подсказками вставки для значений констант:

<code class="language-go">    const (
  KindNone   Kind = iota/* = 0*/
  KindPrint/*  = 1*/
  KindPrintf/* = 2*/
  KindErrorf/* = 3*/
)
</code>

По умолчанию отключено. Включите, установив "hints": {"constantValues": true}.

functionTypeParameters

"functionTypeParameters" подсказки вставки для неявных параметров типа в дженерик-функциях:

<code class="language-go">    myFoo/*[int, string]*/(1, "hello")
</code>

По умолчанию отключено. Включите, установив "hints": {"functionTypeParameters": true}.

ignoredError

"ignoredError" подсказки вставки для неявно отброшенных ошибок:

<code class="language-go">    f.Close() // ignore error
</code>

Эта проверка вставляет подсказку // ignore error после любой инструкции, которая является вызовом функции, результат ошибки которой неявно игнорируется.

Чтобы подавить подсказку, добавьте комментарий, содержащий «ignore error» сразу после вызова функции, или явно присвойте результат пустой переменной. Несколько распространённых функций, таких как fmt.Println, исключены из проверки.

<code class="language-go">    parseInt(/* str: */ "123", /* radix: */ 8)
</code>

<code class="language-go">    for k/* int*/, v/* string*/ := range []string{} {
  fmt.Println(k, v)
}
</code>