批次前綴插入會在貼上的區塊中每一個邏輯行的開頭放置一串字面字串,該區塊最多可達 1,000,000 字元,同時保留原始行的內容、內部空白與順序。專屬的批次工具會一次接收整個區塊、一個前綴、一個可選的後綴,以及一個用於空行的單一開關,然後輸出裝飾後的區塊,使每個輸入行變成「前綴 + 原始行 + 後綴」。由於前綴會被視為字面文字而非正規表示式、取代代號或標記,因此像括號、錢號、反斜線與引號這類字元會按照輸入的原樣插入,這使得操作對於程式碼、記錄檔、SQL 片段以及 shell 註解來說是可預期的。在瀏覽器中於本機執行此裝飾作業,可讓貼上的文字保留在裝置上,而產生的結果則以 UTF-8 TXT 檔案的形式提供,並附有反映下載檔案確切位元組的穩定預覽。
對於維護大量識別項、程式碼行、記錄檔項目或清單列的讀者來說,手動插入前綴既繁瑣又容易出錯。某一行少了一個字元就會產生不一致的結果,下游工具可能會拒絕接受。這就是為什麼會存在像 為每一行加上前綴與後綴 這樣的專屬批次前綴工具:它會一次接收整個區塊、對每一行套用相同的裝飾規則,並在下載前提供預覽。

批次前綴裝飾實際上做了什麼
批次前綴操作比乍聽之下更為簡單。輸入中的每個邏輯行在輸出中都會成為一行新內容,依序為前綴字串、與原本完全一致的原始行內容、以及後綴字串。原始行內部的字元不會被更動:不會修剪首尾空白、不會移除定位點 (tab)、不會改變字母大小寫,也不會進行排序或去除重複。工具只會為空行政策所選定的每一行串接「前綴 + 原始行 + 後綴」。由於前綴與後綴會以字面 Unicode 字串的形式儲存,因此除了常見的 ASCII 標點外,也可以包含非拉丁字元和表情符號。
邏輯行是指位於兩個換行字元之間、輸入開頭到第一個換行字元之間、或最後一個換行字元到輸入結尾之間的內容。可辨識的換行字元包括 CRLF (Windows)、CR (傳統 Mac) 與 LF (Unix),而產生的輸出一律使用 LF。這種標準化表示,從 Windows 上的 Notepad 複製並貼到工具中的清單,與從 Linux 伺服器匯出的清單會產生相同的最終檔案,這正是批次前綴工具存在的實際原因之一。
批次前綴插入最有幫助的情境
| 情境 | 常見的前綴字串 | 使用字面前綴的優勢 |
|---|---|---|
| 註解化程式碼 | // 或 # | 無需逐行編輯即可將每一行停用為註解 |
| 建立記錄檔標記 | [INFO] 、[ERROR] | 為每一行標上分類標籤,方便日後以 grep 搜尋 |
| 將純文字清單轉為項目符號 | - 或 * | 一步驟為每個項目加上項目符號字元 |
| 為 SQL 識別項加上引號 | ' (搭配對應的後綴) | 使用資料庫所要求的字元精確包裹每個識別項 |
| 標示 shell 輸入 | $ | 在轉錄內容中以視覺方式區分輸入指令與輸出 |
| 建立 Markdown 參考連結 | [ (搭配結尾為 ] 的後綴) | 一次掃過清單即可開始 Markdown 連結參考 |
許多情境也能從互補的後綴中獲益,這也是為什麼同一個工具同時支援兩者。將識別項以 '…' 包起來,或為每個項目加上 (…) 包圍,當前綴與後綴一起設定時就是一個步驟即可完成的操作。由於每個詞綴最多可接受 200 個 Unicode 字元,較長的註解橫幅與樣式化的開頭標籤都能從容地納入限制之內。
如何批次為每一行加上前綴
- 將要裝飾的行貼上或輸入到輸入欄位中。該區塊可以少到只有一行,也可以多到總計 1,000,000 字元。
- 輸入要放在每一行前面的前綴字串。如果您同時需要結尾標籤、引號或分隔符號,請將其輸入到後綴欄位。每個詞綴最多可接受 200 個 Unicode 字元,且兩者中至少要有一個不是空白。
- 選擇是否應保持空行不變。當啟用此選項時,空行以及只包含空白的行會以與輸入完全一致的內容返回。當停用時,每一個邏輯行都會被裝飾,包括空白行與僅含空白的行。
- 產生結果,然後檢查預覽。預覽會在預先格式化 (preformatted) 的區域中呈現,以保留空格與定位點,使縮排能完整保留,而視覺上的長行換行並不會插入真正的換行字元。
- 將產生的文字以 UTF-8 TXT 檔案下載。該檔案包含預覽中所顯示的確切字串,以 LF 換行連接,沒有位元組順序記號 (BOM)、沒有外圍引號,也沒有源自檔名的前綴。
無論輸入是電子郵件地址清單、堆疊追蹤、一串 SQL 識別項,或是一段貼上的 Markdown 參考連結,這個流程都相同。由於工具絕不上傳輸入內容,唯一的網路活動就是頁面本身的載入。
作為一個小型的說明,請考慮三行 alpha、beta 與 gamma,搭配 >>> (三個字元) 的前綴且無後綴。輸出結果為 >>>alpha、>>>beta 與 >>>gamma,每一行後面接著一個換行字元。對於一個較長的檔案,若包含 1,000 行、每行 10 字元,並搭配 4 字元的前綴,則輸出包含 (4 + 10) × 1,000 = 14,000 字元,遠低於 1,000,000 字元的輸入上限,也完全落在 200 字元的前綴限制之內。
選擇空行的處理方式
| 輸入行 | 啟用「空行保持不變」 | 停用「空行保持不變」 |
|---|---|---|
| task | prefix task suffix | prefix task suffix |
| (三個空格) | returned exactly unchanged | prefix suffix |
| (empty) | returned exactly unchanged | prefixsuffix |
| 結尾換行後的最後一行 | 當啟用略過空行時保持空白 | 當停用略過空行時加上詞綴 |
結尾換行的規則是刻意設計的。當檔案以一個結尾換行字元結束時,輸入會比大多數編輯器所顯示的多出一個邏輯行,而工具會尊重這個邊界,而不是悄悄地將其忽略。如果最後一行是空白且啟用了空行略過,則保持空白;如果停用了空行略過,則會加上前綴與後綴。因此,選擇正確的開關會改變哪些行會被裝飾,但絕不會刪除任何行,這保留了「行的順序與原始內容皆不被更動」的約定。
理解前綴字元的解譯方式
由於前綴與後綴都是字面字串,因此每個字元都會以輸入的原樣插入。前綴中的反斜線在輸出中仍是反斜線;錢號不會被解譯為變數;括號不會與內容進行配對;方括號不會被轉換成 Markdown 連結語法;星號也不會變成強調標記。當同一個工具用於準備程式碼範例、shell 腳本、記錄檔行或 SQL 片段,且下游解析器會以各自的跳脫規則進行讀取時,這種可預期性至關重要。
一個實際的結果是,該工具不需要知道它正在裝飾什麼類型的文字。同樣的 // 前綴能正確地裝飾 JavaScript、TypeScript 與 C 風格的註解,而同樣的 '…' 包圍能產生大多數資料庫都能接受的 SQL IN 清單。如果下游格式需要跳脫 — 例如,包含逗號、雙引號或換行字元的 CSV 欄位 — 則該跳脫必須另外進行,因為除了字面詞綴之外,工具不會再加入引號、跳脫或分隔符號偵測。
輸出格式、檔案大小與下載行為
可下載的檔案是一個帶有文字 MIME 類型標籤的 UTF-8 純文字 Blob。其內容與預覽中顯示的字串完全一致,僅以 LF 作為唯一的換行字元,沒有位元組順序記號 (BOM)、沒有富文字樣式、沒有試算表引號,也沒有 CSV 跳脫。預覽內部的視覺換行並不會在檔案中插入真正的換行字元,因為預覽是一個預先格式化的區域,會以視覺方式換行而不新增字元。下載的檔案就是產生的字串本身,而非複製的渲染後 HTML,這表示您在預覽中看到的內容就是您儲存的內容。
編輯輸入、前綴、後綴或空行開關會清除先前的結果並撤銷其下載 URL,這可防止在控制項描述不同的輸出時,先前的檔案仍保持可下載狀態。空白的輸入或超出 1,000,000 字元限制的輸入會引發可見的錯誤,而不是產生不完整的檔案。這些規則共同確保下載的文字永遠符合產生當下控制項所描述的內容,這對於批次準備工作而言是最有用的行為。
將批次前綴插入與其他行任務搭配使用
前綴裝飾是許多文字管線中的一個步驟,並能與 Lizely 上其他以行為基礎的工具自然組合。一旦清單被裝飾完成,可能需要為腳本或報告加上連續編號 — 在這種情況下,為每一行文字加上編號的指南 會以相同的逐行模式,並透過專屬的配套工具進行說明。如果來源清單包含意外的重複項目,那麼 一鍵移除重複的行 就是下一步,它會保留每個項目的第一次出現,並精確保留所保留的文字。這兩個步驟都可以在前綴插入之前或之後執行,而不會改變前綴工具所套用的規則。
對於最終匯出,「為每一行加上前綴與後綴」本身會產生一個 UTF-8 TXT,可以直接匯入編輯器、shell 管線與貼上目標,無需進一步轉換。由於整個工作流程都在瀏覽器中進行,同一個區塊可以從貼上、預覽到下載,都不離開裝置,這就是使用瀏覽器型批次前綴工具而非安裝腳本或開啟桌面編輯器的實際好處。