Bulk QR Code Generator 是一個以瀏覽器為基礎的 API 替代方案，可在當前的分頁中將最多 20 個獨特的文字或網址列分別轉換成 QR Code PNG 檔案，並同時完成編碼與 PNG 渲染。與其將值送到伺服器端產生作業，不如貼上最終清單、選擇畫布與容錯等級，然後在瀏覽器中產生預覽。這讓它成為需要個別檢視與個別下載的小批量作業的實用解決方案。此工具最多接受 20 個獨特值，每列限制為 2,000 個 JavaScript 字元，會去除前後空白、移除空行，並合併完全重複的項目。每個通過的值都會獲得一個具索引且具決定性的檔名，以及專屬的下載連結。不會產生 ZIP 封存，也不會自動連續下載 20 個檔案。您只選擇已驗證的所需檔案。所有承載文字與產生的 PNG data URL 都保留在當前的瀏覽器分頁中；它們不會被上傳、縮短、追蹤或記錄。如果某個承載值超過 QR 的容量，產生器會回報錯誤，而不是將不完整的批次標示為已完成。
最多 20 個符號的本地 API 替代方案
關鍵差異在於所執行的工作類型。Bulk QR Code Generator 透過互動式瀏覽器工作流程處理一份有限的、由使用者檢視的清單。以 API 為導向的解決方案則設計為讓程式碼以程式化方式送出產生請求並接收結果。當輸入已存在於文字清單、試算表欄位、活動文件或內容工作表中，且可貼上為每行一個值時，本地方式便相當實用。
| 需求 | 最佳選擇 | 原因 |
|---|---|---|
| 建立最多 20 個獨特的 QR Code | 本地批次工作流程 | 從一份通過的清單產生並檢視個別的 PNG 預覽。 |
| 將承載值保留在當前分頁中 | 本地批次工作流程 | 編碼與 PNG 渲染皆在瀏覽器中執行。 |
| 驗證實際解碼後的值 | 本地批次工作流程 | 每個預覽都可以用目標裝置與應用程式掃描。 |
| 從應用程式碼送出產生請求 | 以 API 為導向的工作流程 | 本地頁面的互動無法取代應用程式整合。 |
| 處理超過 20 個值的重複性批次 | 以 API 為導向的工作流程 | 文件記載的本地批次上限必須拆分為多個作業來處理。 |
對於一份小型且明確的清單而言，避免伺服器來回行程能讓檢視更直接。您在產生前掌控最終值、看到每個結果、掃描目的端，且只下載通過驗證的檔案。取捨在於這是基於瀏覽器的批次工作，而非內建於另一個系統中的自動化請求迴圈。
準備一份每行一個項目的最終清單
請從每行一個文字或網址開始。請勿將多個值放在同一行，也勿依賴逗號來分隔，因為產生器會將每個換行字元視為獨立的輸入值。一旦送出，解析器會去除前後空白、移除空行，並在保留首次出現順序的前提下對完全重複的行進行去重。
整體批次最多只能包含 20 個獨特值。由於重複項在解析後只計算一次，三個相同的行會變成一個輸出，而非三個。單行最多可包含 2,000 個 JavaScript 字元。這是字元數上限，並非保證上限內的每個值都能被編碼。
QR 容量也取決於內容與所選的容錯等級。較長的值雖然可落在 2,000 字元的輸入上限內，仍可能超過該 QR 符號的容量。發生這種情況時，工具會顯示錯誤，而不是回傳一個被標示為完整的不完整集合。較長的 UTF-8 文字與表情符號也可能影響編碼或掃描器行為，而底層的 qrcode 函式庫也指出並未完整實作 ECI 支援。請以目標讀取器測試任何非 ASCII 或異常長的承載值。
若網址來自重複的範本而非既有的手動維護清單，可先使用 適用於瀏覽器端清單的 Bulk URL Generator 來建立來源清單。檢視產生的值之後，再將最終網址貼到 QR 批次中。將準備與產生分成各自經過檢視的步驟，能讓檔名對應與掃描驗證更為容易。
為最終放置位置選擇 PNG 大小
產生器提供 128、256 或 512 像素的 PNG 畫布。畫布的選擇控制的是影像尺寸，而非 QR 符號能容納的資料量。較多的像素可在符號以較大尺寸顯示或列印時改善外觀，但 512 像素的影像所承載的編碼資訊並不會比同一承載值的較小版本多。
| PNG 畫布 | 在可用選項中的位置 | 選擇指引 |
|---|---|---|
| 128 像素 | 最小 | 當該尺寸適合最終放置位置時，使用清單中最小畫布。 |
| 256 像素 | 中間 | 當需要較大畫布但不必選擇最大值時，使用中間選項。 |
| 512 像素 | 最大 | 當符號將以較大尺寸顯示或列印時，使用最大畫布。 |
請以實際的顯示或列印尺寸評估所選的畫布。較大的影像並無法克服顯示器像素化、對比不足、反光、物理性損壞，或不正確的容錯選擇。下載後請在符號周圍保留清晰的靜止區，並請勿拉伸、重新上色、裁切或遮蓋定位圖案。
依環境搭配容錯等級
容錯分為四個等級：L、M、Q 與 H。較高的等級提供更強的還原能力，但會減少符號可用來承載資料的空間，並可能產生更密集的 QR Code。DENSO WAVE 所述 L、M、Q、H 的近似還原率分別為 7%、15%、25% 與 30%。
| 等級 | 近似還原率 | 取捨 |
|---|---|---|
| L | 7% | 四個選項中最低的還原等級，並擁有最多的可用資料容量。 |
| M | 15% | 適用於一般乾淨顯示環境的實用預設值。 |
| Q | 25% | 還原能力較 M 更強，但資料容量較少。 |
| H | 30% | 最高的還原等級，四者中可用資料容量最少。 |
較高的容錯並非自動代表更好。在輸入已接近容量上限時選擇 H，可能會產生更密集的符號而使目標裝置更難掃描。請從 M 開始用於乾淨的顯示環境，之後只有在放置位置或承載值需要經過測試的取捨時再進行調整。
使用專案中既有的編碼器
Bulk QR Code Generator 將編碼作業委由 Lizely 的單一 QR Code Generator 已在使用的 qrcode 1.5.4 套件執行。批次工作流程在用戶端執行，使用所選的寬度與容錯等級搭配邊界 2，並透過該函式庫的瀏覽器 API 回傳 PNG data URL。它並未維護第二套 QR 實作，也未重複容量表。node-qrcode 瀏覽器 API 說明文件 描述了底層的用戶端作法。
產生、掃描並下載 PNG
請使用 Bulk QR Code Generator 進行此本地批次工作流程：
- 貼上最終值。每行放一個文字或網址，最多 20 個獨特的行，且任何一行的字元數不得超過 2,000 個 JavaScript 字元。若空白行不具意義，請手動移除，並在產生前決定是否保留重複的值。
- 選擇 PNG 大小與容錯等級。為畫布選擇 128、256 或 512 像素。一般乾淨的顯示環境可從等級 M 著眼，或在考量承載值、可用容量與最終放置位置後選擇其他等級。
- 選擇產生 QR codes。通過的值會在瀏覽器中編碼。若某個承載值超過 QR 容量，請更正輸入並重新產生批次，而非將不完整的結果視為完整。
- 以目標裝置與應用程式掃描每個預覽。逐字元檢查解碼後的承載值。產生的影像並不證明每個掃描器都能讀出預期的值，因此請考量對焦、顯示反光、物理性損壞、過長的 UTF-8 文字、表情符號，以及讀取器特有的行為。
- 個別下載已驗證的 PNG。點擊每個所需預覽所附的下載連結。瀏覽器政策可能要求額外的點擊或下載權限提示，但此工具並不會啟動 20 個自動下載。請保留每個靜止區，並維持定位圖案清晰可辨。
請勿僅根據預覽就發佈、列印、標示庫存、發送活動資料，或取代既有的 QR Code。相同的謹慎態度對付款、身份驗證密鑰、安全指示，或任何難以或無法回復的動作尤其重要。
檢視檔名、隱私與過時的結果
每個預覽都有一個具決定性的檔名，以兩位數的批次位置開頭，加上由其內容衍生的簡短 ASCII 字幹。例如，https://example.com 會變成 01-example-com.png。若一行中沒有 ASCII 字母或數字，檔名會使用備用字幹 qr-code。這些名稱僅為便利標籤，絕不會更改編碼後的承載值。
承載值與 PNG data URL 都保留在當前的分頁中。不會上傳、縮短、追蹤或記錄任何內容。關閉或以新的輸入取代批次時，先前的結果會從使用中的工作流程中清除。更換輸入或選項也會使先前的批次失效，而一組非同步作業識別碼可防止較舊的產生結果覆蓋較新的設定。
首次出現的順序至關重要，因為它同時控制了每個檔名中的批次位置，以及預覽呈現的順序。若某個承載值對所選的 QR 設定而言過大，工具會回報錯誤，而非悄悄將其捨棄。請將該訊息視為縮短值、選擇其他容錯等級，或採用其他編碼方案的訊號。
Use an API when the job grows past a small local batch
The practical decision is straightforward: use Bulk QR Code Generator when the job contains up to 20 unique values, the browser workflow is acceptable, and individual review is valuable. Use an API-oriented approach when application code must request generation, the operation must run continuously, or each job must handle more than 20 values. The local tool is an alternative for a small batch, not an unlimited substitute for a programmatic integration.
Prepare and verify the complete list before opening the generator. Once the previews pass the target-device scan check, download the required files individually and retain the source list beside them. The combination of local processing, explicit batch limits, deterministic labels, separate PNG downloads, and target-device verification gives each output a clear review path without introducing a server request or archive dependency.
Related reading: Bulk URL Generator for Large Text: Up to 10,000 URLs.