Inline Beacon

在程式碼行尾直接顯示診斷訊息，並高亮與清除尾端空白；狀態列一眼看到錯誤、警告與尾端空白的數量。

原始碼與問題回報：https://github.com/lazyjerry/code-beacon-ext

功能

診斷行內訊息

• 行尾顯示問題：錯誤、警告、資訊直接顯示在該行行尾（提示預設不顯示，可用 codeBeacon.diagnosticLevels 打開），不必 hover 或開「問題」面板。
• 訊息樣板：預設 $severity $message，前面是嚴重度符號（✖ ▲ ● ◇，可改），後面是訊息；另有 $count（同一行問題數，超過一個才顯示）、$source、$code 可用。
• 底色：整行、只有訊息、或不上色三選一；也可另外標出問題的實際範圍。
• 跟隨游標：可只顯示游標所在行、除了游標行以外、或離游標最近的一則。
• 對齊欄位：訊息可從固定欄位開始或結束，長行自動退回最小間距。
• gutter 圖示：行號旁顯示嚴重度圖示，方塊、圓形、字母、emoji 四種樣式，顏色與 emoji 可自訂。
• 存檔模式：可改成只在存檔後顯示幾百毫秒，平常不干擾。
• 排除：依來源（eslint、eslint(no-unused-vars)）或訊息 regex 隱藏不想看的問題。

尾端空白

• 即時高亮：編輯時把行尾的空格與 tab 標成警告黃（顏色與 regex 可改）。
• 預設僅顯示不清除：不會在存檔時偷偷改檔案。想要存檔自動清除，把 codeBeacon.trailingSpacesHighlightOnly 關掉。
• 只清修改過的行：「清除尾端空白」預設只處理自開檔或上次存檔以來改過的行，不會把整份檔案的 diff 弄髒；要整份清除用「清除尾端空白（整份檔案）」。
• 整行空白的行：預設一起清；codeBeacon.trimIncludeEmptyLines 關掉可保留。
• 游標所在行：預設也高亮；打字時嫌閃可關掉。

狀態列

一個項目顯示 $(error) 錯誤數 $(warning) 警告數 $(info) 資訊數 $(whitespace) 含尾端空白的行數。有錯誤時套錯誤底色、只有警告時套警告底色，點擊開「問題」面板。診斷可選算目前編輯器或所有開啟的文件；尾端空白一律只算目前編輯器。

共用排除

codeBeacon.excludePatterns（glob）、codeBeacon.excludeLanguages（語言識別碼）、codeBeacon.excludeSchemes（document scheme）三條同時作用在診斷與尾端空白。預設跳過 output；加上 untitled 可跳過未存檔的新檔案。

中英雙語

設定頁的說明、指令名稱、訊息都隨 VS Code 的顯示語言切換（繁體中文、英文；其他語言顯示英文）。

指令

從命令面板（Cmd+Shift+P）輸入 Inline Beacon 找到：

快捷鍵

預設不綁任何快捷鍵，也不進右鍵選單。要綁的話在 Keyboard Shortcuts 搜尋 codeBeacon，或在 keybindings.json 加：

[
  { "key": "cmd+alt+w", "command": "codeBeacon.trimTrailingSpaces", "when": "editorTextFocus" },
  { "key": "cmd+alt+shift+w", "command": "codeBeacon.trimTrailingSpacesAll", "when": "editorTextFocus" },
  { "key": "cmd+alt+b", "command": "codeBeacon.toggle" }
]

設定

全部 41 條，前綴 codeBeacon.。

共用

診斷

尾端空白

顏色

診斷的顏色是 theme color，在 workbench.colorCustomizations 覆寫。四種嚴重度（error、warning、info、hint）各有四個：

例：

"workbench.colorCustomizations": {
  "codeBeacon.errorForeground": "#ff8080",
  "codeBeacon.warningBackground": "#ff942f10"
}

尾端空白的顏色是一般設定（trailingSpacesBackgroundColor、trailingSpacesBorderColor），不是 theme color。

限制與已知差異

• 存檔自動清除與內建 files.trimTrailingWhitespace 的差別：內建的會清整份檔案的所有行；本延伸模組的（trailingSpacesHighlightOnly: false）遵守 trimModifiedLinesOnly、trimIncludeEmptyLines 與自訂 regex。兩者同時開會各清各的，建議只留一個。
• 「修改過的行」以編輯事件計算，開檔或存檔後歸零。用外部工具改了檔案再回到 VS Code，那些變更不算修改過的行。
• 狀態列的尾端空白計數只算目前編輯器，即使 statusBarScope 是 all。
• 受限模式（Restricted Mode）：searchForProblemQuery、trailingSpacesRegexp、excludeByMessage 不接受工作區設定，改用使用者設定的值。
• diff 檢視左側（git: scheme）與 SCM 輸入框不裝飾。
• problems.visibility 關掉時，診斷行內訊息一併隱藏。

開發

見 CONTRIBUTING.md。