如何使用 Node.js 壓縮 PDF 檔案

我應該使用哪種品質設定？

合適的品質設定取決於壓縮後的 PDF 將如何使用：

• 90-100：近乎無損。 適用於文件將被列印或以全螢幕檢視的情況。
• 80-89：高品質，檔案明顯較小。此為多數商務文件的預設起點。
• 60-79：中等品質。 適用於螢幕顯示、網頁發布及電子郵件附件。
• 低於 60：品質不佳。 適用於預覽縮圖、歸檔副本，或檔案大小至關重要的情況。

如何在 Node.js 中測量壓縮結果？

使用 Node.js 的 fs 模組，即可輕鬆驗證壓縮效果是否達到預期的減量。 請先讀取呼叫 compressSize 前後的檔案大小，再計算比例以確認結果符合您的應用程式需求。

```javascript {.line-numbers} //:path=/static-assets/pdf/content-code-examples/how-to/nodejs-compress-pdf/measure-compression.js import { PdfDocument } from "@ironsoftware/IronPDF"; import { statSync } from "fs";

const inputPath = "annual-report.pdf"; const outputPath = "annual-report-compressed.PDF";

const beforeBytes = statSync(inputPath).size;

const pdf = await PdfDocument.fromFile(inputPath); await pdf.compressSize(75); await pdf.saveAs(outputPath);

const afterBytes = statSync(outputPath).size; const reduction = (((beforeBytes - afterBytes) / beforeBytes) * 100).toFixed(1);

console.log(Before: ${(beforeBytes / 1024).toFixed(1)} KB); console.log(After: ${(afterBytes / 1024).toFixed(1)} KB); console.log(Reduced by ${reduction}%);

[Node.js](https://nodejs.org/api/fs.html#fsstatsynspath-options) 的 [`fs.statSync` API](https://nodejs.org/api/fs.html#fsstatsynspath-options) 會傳回一個 `Stats` 物件，其中包含以位元組為單位的 `size` 屬性。 針對生產管線，請針對每份文件記錄此壓縮率，以便識別壓縮效果未如預期縮減檔案大小的異常值——通常是源頭已壓縮的掃描文件。

重要事項在伺服器環境中處理檔案前，請設定 `IRONPDF_ENGINE_PATH` 環境變數或配置 `IronPdfGlobalConfig`。 （有關引擎設定的詳細資訊，請參閱 [IronPDF](https://ironpdf.com/nodejs/docs/) for [Node.js 文件](https://ironpdf.com/nodejs/docs/)。）}]

## 如何批次壓縮多個 PDF 檔案？

生產環境中的應用程式很少會孤立地壓縮單一文件。 以下範例使用 `Promise.all` 並行處理一組檔案路徑，此機制可讓 Node.js 事件迴圈在不阻塞的情況下處理多項 `compressSize` 操作：

```javascript {.line-numbers}
//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-compress-pdf/batch-compress.js
import { PdfDocument } from "@ironsoftware/IronPDF";
import path from "path";

async function compressPdfFiles(inputPaths, quality = 80) {
    const results = await Promise.all(
        inputPaths.map(async (inputPath) => {
            const pdf = await PdfDocument.fromFile(inputPath);
            await pdf.compressSize(quality);

            const outputPath = inputPath.replace(".pdf", "-compressed.pdf");
            await pdf.saveAs(outputPath);

            return { input: inputPath, output: outputPath };
        })
    );

    return results;
}

// 使用方式
const files = ["report-q1.pdf", "report-q2.pdf", "report-q3.pdf"];
const compressed = await compressPdfFiles(files, 75);
compressed.forEach(r => console.log(`Saved: ${r.output}`));

每次對 PdfDocument.fromFile 和 compressSize 的呼叫皆為獨立操作，因此可安全地進行平行處理。若處理非常龐大的批次（數百個檔案），請考慮將陣列分塊處理，以避免超過 Node.js 的記憶體限制。 Node.js 關於事件迴圈的文件說明了 Promise.all 如何在不阻塞主執行緒的情況下，排程並發 I/O 作業。

如何將壓縮功能與其他 PDF 操作結合使用？

壓縮功能自然地融入更廣泛的文件處理流程中。 常見的流程是將 HTML 轉為 PDF，加入浮水印或簽名，然後在傳送前進行壓縮：

```javascript {.line-numbers} //:path=/static-assets/pdf/content-code-examples/how-to/nodejs-compress-pdf/compress-after-render.js import { PdfDocument, ChromePdfRenderer } from "@ironsoftware/IronPDF";

// 將 HTML 渲染為 PDF const renderer = new ChromePdfRenderer(); const pdf = await renderer.renderHtmlAsPdf("

Amount due: $540.00

// 儲存前壓縮 -- 減少 Chrome 渲染內容中的圖片大小 await pdf.compressSize(85);

// 儲存最終文件 await pdf.saveAs("invoice-1042.pdf");

`ChromePdfRenderer` 通常會以全解析度嵌入背景圖片及 CSS 引用的資源。 在渲染後呼叫 `compressSize`，可有效減少源自 HTML 的 PDF 檔案大小。 IronPDF 的 [HTML 轉 PDF 教學](https://ironpdf.com/nodejs/tutorials/html-to-pdf/)詳盡介紹了渲染器的設定。

若文件同時需要[數位簽章](https://ironpdf.com/nodejs/examples/digitally-sign-a-pdf/)，請在壓縮後再進行簽署。 簽署會鎖定文件的位元組流，若進行進一步修改將導致簽名失效。

處理多頁文件時，請在壓縮前使用 [`PdfDocument.merge()`](https://ironpdf.com/nodejs/examples/merge-pdfs/) 將其合併。 將合併後的結果進行壓縮，比分別壓縮各檔案再重新合併更為高效。

提示壓縮前請先合併多頁文件。 (將合併後的結果進行壓縮，比分別壓縮各檔案再重新合併更為高效。

## Node.js 中的 PDF 壓縮技術下一步發展為何？

`compressSize` 方法涵蓋最常見的壓縮應用情境：減輕嵌入式圖片的檔案大小。 針對特殊情境，IronPDF 的 [PDF 壓縮範例](https://ironpdf.com/nodejs/examples/pdf-compression/)提供了額外的實作程式碼範例，而 [API 參考](https://ironpdf.com/nodejs/object-reference/api/)文件則完整記載了所有可用方法的簽名。

IronPDF 亦支援將[圖片](https://ironpdf.com/nodejs/examples/image-to-pdf/)轉換[為 PDF](https://ironpdf.com/nodejs/examples/image-to-pdf/)、[讀取 PDF 文字](https://ironpdf.com/nodejs/examples/reading-pdf-text/)，以及[從 PDF 中刪除頁面](https://ironpdf.com/nodejs/examples/remove-page-from-pdf/)——所有這些操作皆可透過相同的 `PdfDocument` API 進行整合。 如需了解 Node.js PDF 功能的完整概述，請參閱 [IronPDF Node.js 文件](https://ironpdf.com/nodejs/docs/)。

準備好在您的專案中測試壓縮功能了嗎？ [立即開始免費試用](#trial-license)，無水印執行上述範例，或[查看](#licensing)生產環境部署的[授權選項](#licensing)。

`PdfDocument`