使用 批次 QR Code 產生器 產生的批次 QR Code 產生器範例，是一組最多 20 張 PNG 影像的小集合，每張都帶有各自的解碼內容，在瀏覽器中於本地端轉譯，並透過個別的下載連結提供。讀者在一個輸入欄位中，每行貼上一個網址或簡短文字，選擇像素畫布大小和錯誤更正等級，然後收到一排預覽，檔名是確定性的，例如 01-example-com.png。每個預覽都是由驅動本專案單一 QR Code 產生器的同一個 qrcode 1.5.4 編碼器所產生，因此批次工具不會引入第二個可能產生偏差的實作。編碼和 PNG 轉譯都在目前的分頁中進行;不會上傳、縮短或追蹤任何內容。無論來源清單是純文字檔、從試算表複製的欄，或是手動輸入的清單，都適用相同的輸入規則，這正是批次範例對於需要交付固定小批次而非串接 API 端點的團隊而言可預測的原因。檔案設計上是一次下載一個，而且每張下載的 PNG 在列印或發布之前，都必須使用目標裝置掃描。
「批次 QR Code 產生器範例」實際提供的內容
搜尋「bulk qr code generator example」的讀者，通常想看到輸入的形狀、輸出的形狀，以及介於兩者之間的選擇。在本工具中，輸入是單一多行文字區，選擇是像素畫布大小和錯誤更正，輸出則最多為 20 張 PNG 影像，每張都有自己的預覽磚和下載連結。沒有封存的步驟、沒有 ZIP 檔、也沒有伺服器往返。這種狹窄的形狀是有意為之:它讓網頁能完全在瀏覽器中執行，並且無論讀者處理五個或二十個代碼，都能維持一致的心智模型。
這個範例之所以也很小，是因為每個產生的符號都必須在目標裝置上重新掃描。二十個一批仍可在幾分鐘內人工檢視，但兩百個一批會助長複製貼上式的信任，這是產品契約刻意不鼓勵的。因此這個上限形塑的是範例本身，而非僅僅是工作量。
輸入、解析規則與輸出限制
在按下產生按鈕之前，文字區會經過一個小而明確的管線:以換行分隔的文字會依換行分割，前後空白會被修剪，空行會被移除，而完全相同的重複項會摺疊為第一筆出現的版本。順序會保留，因此先出現的行獲勝，後續的複本會被默默丟棄。當來源清單來自試算表欄位、而一次誤貼造成了重複值時，這就特別有用。
需要牢記的兩個硬性限制是批次上限和每行上限。批次上限是去重後的 20 個唯一行;每行上限是每行 2,000 個 JavaScript 字元。字元限制是以 JavaScript 字串的長度來計算，對於純 ASCII 而言等於可見長度，而對於多位元組文字而言則高於可見字形數。
| 限制條件 | 數值 | 在邊界時會發生什麼 |
|---|---|---|
| 每批唯一行數 | 20 | 批次上限為 20 個唯一值。 |
| 每行字元數 | 2,000 | 每行上限為 2,000 個 JavaScript 字元。 |
| 重複的行 | 摺疊 | 修剪後完全相同的重複項會被移除;以第一筆出現者為準。 |
| 空行或僅含空白的行 | 移除 | 修剪後不含任何可見內容的行會被丟棄。 |
若某個承載內容超出所選大小和錯誤更正等級的 QR 容量，批次會顯示錯誤，而不是呈現一個看似完整的不完整集合。這種大聲失敗的行為就是契約本身，也正是它能避免「看起來沒問題」的誤導性預覽被下載並出貨的原因。
從單一窗格產生 20 張 PNG
完整的範例可在單一畫面中完成，並遵循同樣的三個步驟，無論來源清單從何而來。
- 每行貼上一段文字或網址。在修剪與去重後，清單需保持 20 行或以下的唯一行。像 https://example.com 這樣的網址會成為確定性檔名 01-example-com.png 的種子。
- 選擇 PNG 畫布大小和錯誤更正等級，然後選取產生 QR codes。畫布大小可選 128、256 或 512 像素;錯誤更正可選 L、M、Q 或 H。預覽列只有在產生器回傳後才會出現。
- 使用目標裝置掃描每個預覽，然後個別下載已驗證的 PNG。請使用在實際生產環境中將讀取代碼的那支手機和掃描應用程式。只有解碼正確的代碼才應下載以供發送。
下載步驟刻意設計為每個檔案點擊一次。網頁不會觸發 20 次自動下載，那會讓使用者感到意外，並使選取的輸出無法區分。想要單一封存的讀者可以手動將下載的檔案收集到一個資料夾中;工具本身並不會將它們打包。
錯誤更正等級與 PNG 大小
像素畫布大小和錯誤校正是獨立的設定，但它們以相反的方式與 QR 容量互動。較大的畫布並不會增加資料容量;它只是將相同的模組網格分散到更多像素上，當符號以較大的實體尺寸顯示或列印時，這可能會有幫助。另一方面，錯誤更正會直接以容量換取還原能力:較高的等級會將較大比例的符號保留給冗餘資料，這會迫使編碼器將相同的承載內容塞入更密集的網格。
| 等級 | 大約的碼字還原比例 | 對符號的影響 |
|---|---|---|
| L | 7% | 最高容量，最低冗餘。 |
| M | 15% | 在乾淨的顯示條件下，平衡的預設值。 |
| Q | 25% | 對污漬或部分遮擋有較佳的還原能力。 |
| H | 30% | 最強的還原能力，可用的容量最小。 |
這些還原比例是 DENSO WAVE(QR Code 規格的原始發布者)針對四個標準等級所描述的近似值。它們有助於挑選等級，但並不等同於保證的掃描成功率，因為真實世界的表現取決於列印大小、對比、眩光、相機對焦以及讀取器的行為。對於大多數列印標籤和乾淨的螢幕顯示而言，M 等級是實務上的預設值。
下載後，請在影像周圍保留一塊乾淨的靜止區。避免拉伸、重新上色、裁剪或遮蓋角落的三個定位圖案;任何這些動作都可能讓編碼完全正確的符號變得無法讀取。像素大小和靜止區是保存方面的考量，而非產生方面的考量。
在列印或發布之前驗證每個代碼
產生的影像並不能證明每個掃描器都能讀取預期的內容。同一個符號在配備內建相機應用程式的近期手機上可以正確掃描，卻可能在較舊的裝置、資訊站讀取器或低光環境中失敗。產品契約要求對每張下載的 PNG 進行目標裝置掃描，並將驗證視為範例的一部分，而不是事後清理。
驗證清單很短:開啟目標應用程式，將它對準預覽或下載的 PNG，然後逐字元檢查解碼出來的承載內容。較長的 UTF-8 字串、表情符號，以及名片或 Wi-Fi 承載內容都能受益於明確的檢查，因為部分讀取器會對它們進行正規化或截斷。支援編碼器的程式庫也註明未實作完整的 ECI 支援，這可能會影響部分掃描器中的非 ASCII 文字。
將用於付款、認證密鑰、安全指示或任何不可逆動作的代碼，絕對不應從未經檢查的批次中部署。正確的模式是將驗證步驟視為批次範例的一部分，並延遲發送，直到每個符號在實際將掃描它的裝置上都能讀取到預期的承載內容。
批次範例的適用範圍界線
批次範例的上限為 20 張唯一 PNG，並非因為更大的批次不可能，而是因為此工具是圍繞一個小型、僅限瀏覽器的工作流程所打造，每次下載點擊一次、每個代碼掃描一次。需要數百個符號用於產品標籤、活動識別證或郵寄品的團隊，有幾條誠實的途徑:用平移過的輸入清單重複執行以擴展範例、離線準備較長的來源清單並以切片方式透過同一工具送入，或改用專用的代碼產生 API。每條途徑都保留了相同的輸入規則和相同的驗證要求。
檔名標籤僅供方便使用，絕不會更改編碼的承載內容，因此為了庫存系統重新命名檔案是安全的。在頁面中變更輸入行或選項會使先前的批次失效，而內部的工作識別碼可防止較舊的結果覆蓋較新的設定。所有承載內容和 PNG 資料 URL 都保留在目前的分頁中，在頁面關閉時即被丟棄，這正是為什麼另外儲存來源清單是乾淨批次範例的一部分。
對於想要相關逐步解說的讀者，如何從純文字清單產生多個 QR Code 這份指南從「以清單為先」的角度涵蓋了相同的輸入管線，而 node-qrcode 的程式庫文件則說明了編碼器所使用的底層瀏覽器 API 與容量指引。