用於 doxygen 樣式注釋的 Visual Studio 代碼片段

Question

是否有一個片段/擴展允許我突出顯示多行文本並使用鍵綁定，在它們前面添加 doxygen 樣式字符/// ，就像ctrl+/對 C/C++ 注釋所做的那樣？ 這將非常有幫助。

Answer 1

您可以使用擴展Regex Text Generator 。

使用多光標選擇要注釋的行/文本，然后應用鍵綁定。

添加以下鍵綁定

  {
    "key": "ctrl+f7",  // or any other key combo
    "when": "editorTextFocus",
    "command": "regexTextGen.generateText",
    "args": {
      "generatorRegex" : "/// {{0}}"
    }
  }

---

在Regex Text Generator擴展的 0.9.0 版中，我添加了使用第一個選定行的部分的可能性。

通過以下鍵綁定，您可以使用第一行的空白部分並確定注釋字符的縮進：

  {
    "key": "ctrl+f7",  // or any other key combo
    "when": "editorTextFocus",
    "command": "regexTextGen.generateText",
    "args": {
      "originalTextRegex": "([ \\t]*)(.*)",
      "generatorRegex" : "{{1:first}}/// {{1:-first}}{{2}}"
    }
  }

空行現在也將正確縮進。

您可能需要使用Trim Trailing Whitespace ( Ctrl + K Ctrl + X )

如何選擇要評論的行：

• 轉到第一行的開頭，第 1 列
• 添加額外的光標： Add Cursor Below Ctrl + Alt + DownArrow Add Cursor Below
• 選擇完整的行： Shift + End
• 調用定義的鍵綁定：這里Ctrl + F7
• 退出多光標模式： Esc

與塊選擇Shift + DownArrow相比沒有太大區別。 一旦您對多光標感到滿意，您就會想知道沒有它怎么辦。

只需閱讀Justin Grant的 VSC 多光標技巧，即可使用鼠標和修飾鍵Shift + Alt創建多光標選擇。 對於非常多的行，這可能很方便。

Answer 2

如果您有多個選擇，它就像這個鍵綁定一樣簡單：

{
  "key": "alt+w",
  "command": "editor.action.insertSnippet",
  "args": {
    "snippet": "/// ${TM_SELECTED_TEXT}"  
  },
  "when": "editorHasMultipleSelections && textInputFocus"
},

---