Gopls：功能索引

此頁面提供了 gopls 透過 語言伺服器協議 (LSP) 支援的所有功能的索引。它面向

• gopls 使用者，幫助他們瞭解其功能，從而最大程度地利用其編輯器；
• 編輯器維護者，幫助他們在支援 LSP 的編輯器中新增或改進 Go 支援；以及
• gopls 貢獻者，幫助他們理解其工作原理。

理想情況下，Go 使用者不需要知道 gopls 甚至 LSP 的存在，因為支援 LSP 的編輯器會實現協議的各個方面，並以自然且可發現的方式暴露每個功能。但實際上，不同編輯器對 LSP 的支援程度差異很大，因此不幸的是，這些文件必然會涉及協議的許多細節。

我們還列出了影響每個功能的 設定。

大多數功能都以 VS Code 為例進行說明，但我們會簡要提及其他流行客戶端是否支援該功能，以及如何找到它。我們歡迎任何編輯器的使用者進行貢獻、編輯和更新。

貢獻者在對現有功能進行重大更改或新增新功能時，應 更新本文件。

• 被動式：始終開啟且無需特殊操作的功能
  • 懸停：有關游標下符號的資訊
  • 簽名幫助：有關包含的函式呼叫的型別資訊
  • 文件高亮：高亮指向同一符號的識別符號
  • 內嵌提示：顯示結構體欄位和引數名稱的隱式名稱
  • 語義標記：報告編輯器用於著色文字的語法資訊
  • 摺疊範圍：報告可以在編輯器中“摺疊”（展開/摺疊）的文字區域
  • 文件連結：從文件註釋、當前檔案中的字串中提取 URL，以便客戶端可以連結化
• 診斷：編譯錯誤和靜態分析結果
• 導航：交叉引用、型別和符號的導航
  • 定義：轉到選定符號的定義
  • 型別定義：轉到選定符號型別的定義
  • 引用：列出對選定符號的引用
  • 實現：顯示選定型別的“實現”關係
  • 文件符號：當前檔案中定義的符號大綱
  • 符號：按名稱模糊搜尋符號
  • 選擇範圍：選擇包含的語法單元
  • 呼叫層級：顯示當前函式的出站/入站呼叫
  • 型別層級：顯示當前型別的介面/實現
• 補全：識別符號、語句的上下文感知補全
• 程式碼轉換：修復和重構
  • 格式化：格式化原始碼
  • 重新命名：重新命名符號或包
  • 整理匯入：整理匯入宣告
  • 提取：將選定內容提取到新檔案/函式/變數
  • 內聯：行內函數或方法的呼叫
  • 雜項重寫：各種 Go 特定的重構
  • 為函式新增測試：為選定的函式建立測試
• 基於 Web 的查詢：開啟瀏覽器頁面的命令
  • 包文件：瀏覽當前 Go 包的文件
  • 自由符號：顯示選定程式碼塊使用的符號
  • 彙編：顯示選定函式的彙編程式碼列表
  • 拆分包：將一個包拆分為兩個或多個元件
• 對非 Go 檔案支援
  • 模板檔案：由 text/template 和 html/template 解析的檔案
  • go.mod 和 go.work 檔案：Go 模組和工作區清單
  • Go *.s 彙編檔案：Go 彙編檔案
• 命令列介面：用於除錯和指令碼的 CLI（不穩定）
• 模型上下文協議：在 AI 輔助環境中使用某些功能

您可以透過在編輯器中執行 gopls.doc.features 程式碼操作來找到此頁面，該操作會在 Web 瀏覽器中開啟它。在 VS Code 中，您可以在“快速修復”選單中找到它。