NODE 說明

fs extra npm（開發者的使用方法）

Name: IronPDF
Brand: Iron Software
Availability: InStock
Rating: 4.87 (307 reviews)

更新:2026年1月18日

Node.js 是一個強大的 JavaScript 執行環境，它提供了一個有效且可擴展的應用程式開發環境，改變了伺服器端程式設計。在眾多提供給開發者的 Node.js 套件中，fs-extra 和 IronPDF 因其先進的檔案處理能力和 PDF 建立能力而脫穎而出。

fs-extra 是 Node 的原生 fs 模組的增強版本。它提供了一個更易於使用的 API 和額外的檔案操作方法，如複製、移動和刪除。非同步編程因為有支持 promise 而變得更容易，這確保了平滑的檔案系統管理並簡化了 JSON 檔案的處理。

反之，IronPDF 是一個強大的 PDF 程式庫，允許程式員生成、修改和提取 PDF 文件的內容。它適用於從 HTML 或未格式化文本創建 PDF 文件，合併多個 PDF，以及向 PDF 添加頁眉、頁腳、水印及其他自定義項。這使其成為即時創建發票、報告及其他文件的寶貴工具。

通過整合 fs-extra 和 IronPDF，開發者可以在其 Node.js 應用中創建複雜的檔案管理系統並生成專業質量的 PDF。這種組合保證了程式能有效處理複雜的檔案和文檔處理任務，同時提高生產力。

什麼是 fs-extra npm？

fs-extra 套件是一个灵活的 Node.js 工具，通过提供更多功能来扩展内建的 fs（文件系统）模组，以简化常规文件操作。它提供了如 fs.move 和 fs.remove 這樣的函數，使複製、移動和刪除檔案和目錄的任務更容易。此外，fs-extra 還配備了讀寫 JSON 檔案（fs.readJson, fs.ensureDir, fs.ensureFile）及執行其他方便操作的工具。它支持 Promises，允許使用 async/await 語法來更舒適地管理非同步編程。所有的 fs 方法都返回 promises，fs-extra 也包含同步方法。

fs extra npm (How It Works For Developers): Figure 1 - Node.js: fs-extra

fs-extra 的功能

fs-extra 擴展了原生 fs 模組的功能，是 Node.js 的一個改良版本的文件系統模組。它是開發者的熱門選擇，提供了一系列強大而實用的技術來管理檔案和目錄。相對於原始的 fs 模組，fs-extra 擁有以下功能，並新增支持 promise 的標準 fs 方法：

增強的檔案操作

複製： fs.copy(src, dest)：從源複製目錄和檔案，包括嵌套的內容，到目的地。
移動： fs.move(src, dest)：轉移文件夾和檔案，提供了重新命名的選項。
刪除： fs.remove(path)：遞歸地刪除文件夾和檔案。

目錄操作

確保目錄： fs.ensureDir(path)：驗證目錄是否已經存在；如果不存在，則創建目錄。
清空目錄： fs.emptyDir(path)：刪除目錄的內容，但保留目錄本身。
確保檔案： fs.ensureFile(path)：驗證檔案是否已經存在；如果不存在，則創建檔案。

JSON 處理

讀取 JSON： fs.readJson(path)：讀取 JSON 檔案並解析其內容。
寫入 JSON： fs.writeJson(path, data)：將 JavaScript 對象寫入文件為 JSON。

Promise 支持

基於 Promise 的 API： 大多數方法返回 Promise，使用 async/await 語法編寫非同步代碼變得更容易。

向後相容性

完整 fs 模組支持： fs-extra 包含了所有原生 fs 模組的標準方法，使其成為具有完全向後相容性即插即用的替代方案。

便捷方法

輸出文件： fs.outputFile(path, data)：創建目錄（如果不存在）並將數據寫入檔案。
輸出 JSON： fs.outputJson(path, data)：在以 JSON 格式將 JavaScript 對象寫入文件之前創建文件夾（如果不存在）。
讀取檔案： fs.readFile(path)：讀取檔案的內容。
寫入檔案： fs.writeFile(path, data)：寫入數據到文件。
路徑存在： fs.pathExists(path)：檢查在給定路徑上是否存在文件或目錄。

創建符號鏈接

確保符號鏈接： fs.ensureSymlink(srcpath, dstpath)：檢查是否存在符號鏈接，如果不存在，則創建一個。

使用 fs-extra 創建和配置 Node.js 專案

將 fs-extra 庫用於 Node.js 專案中，方法如下：

設置專案

首先，為您的專案創建一個新目錄，並使用 npm 啟動一個嶄新的 Node.js 專案（npm init -y）。這將為您的應用程序搭建基本框架。

安裝 fs-extra

使用 npm 安裝 fs-extra 庫：

npm install fs-extra

npm install fs-extra

SHELL

使用 fs-extra

為了演示 fs-extra 的用法，打開您喜歡的文本編輯器中的 index.js 並添加以下示例代碼。

// Import the fs-extra module
const fs = require('fs-extra');

// Asynchronous function to perform various file operations
async function performFileOperations() {
  try {
    // Ensure a directory exists; create it if it doesn't
    await fs.ensureDir('exampleDir');

    // Create a file and write some data to it
    await fs.outputFile('exampleDir/exampleFile.txt', 'Hello, world!');

    // Read the file's content
    const data = await fs.readFile('exampleDir/exampleFile.txt', 'utf-8');
    console.log('File Content:', data);

    // Recursively copy the file
    await fs.copy('exampleDir/exampleFile.txt', 'exampleDir/copyOfExampleFile.txt');

    // Move the file to a new location
    await fs.move('exampleDir/copyOfExampleFile.txt', 'exampleDir/movedExampleFile.txt');

    // Remove the file
    await fs.remove('exampleDir/movedExampleFile.txt');

    // Ensure a file exists; create it if it doesn't
    await fs.ensureFile('exampleDir/newFile.txt');

    // Write JSON data to a file
    const jsonData = { name: 'John Doe', age: 30 };
    await fs.writeJson('exampleDir/data.json', jsonData);

    // Read JSON data from a file
    const jsonFileContent = await fs.readJson('exampleDir/data.json');
    console.log('JSON File Content:', jsonFileContent);
  } catch (err) {
    console.error('Error during file operations:', err);
  }
}

// Execute the file operations
performFileOperations();

// Import the fs-extra module
const fs = require('fs-extra');

// Asynchronous function to perform various file operations
async function performFileOperations() {
  try {
    // Ensure a directory exists; create it if it doesn't
    await fs.ensureDir('exampleDir');

    // Create a file and write some data to it
    await fs.outputFile('exampleDir/exampleFile.txt', 'Hello, world!');

    // Read the file's content
    const data = await fs.readFile('exampleDir/exampleFile.txt', 'utf-8');
    console.log('File Content:', data);

    // Recursively copy the file
    await fs.copy('exampleDir/exampleFile.txt', 'exampleDir/copyOfExampleFile.txt');

    // Move the file to a new location
    await fs.move('exampleDir/copyOfExampleFile.txt', 'exampleDir/movedExampleFile.txt');

    // Remove the file
    await fs.remove('exampleDir/movedExampleFile.txt');

    // Ensure a file exists; create it if it doesn't
    await fs.ensureFile('exampleDir/newFile.txt');

    // Write JSON data to a file
    const jsonData = { name: 'John Doe', age: 30 };
    await fs.writeJson('exampleDir/data.json', jsonData);

    // Read JSON data from a file
    const jsonFileContent = await fs.readJson('exampleDir/data.json');
    console.log('JSON File Content:', jsonFileContent);
  } catch (err) {
    console.error('Error during file operations:', err);
  }
}

// Execute the file operations
performFileOperations();

JAVASCRIPT

上面的代碼片段展示了改良的 Node.js 文件系統模組，fs-extra 庫的功能。該程序實現了一個名為performFileOperations的非同步方法，用於在import fs-extra之後執行若干檔案操作。使用 fs.ensureDir() 方法，它首先验证名为"exampleDir"的目录是否存在。然后，使用 fs.outputFile() 方法，在该目录下创建名为"exampleFile.txt"的文件，并将文本"Hello, world!"写入其中。使用 fs.readFile()，程式讀取檔案的內容並將其記錄到控制台中。

控制台輸出

fs extra npm (How It Works For Developers): Figure 2 - Console output for the Node.js application using fs-extra library for file handling.

此外，它還使用像 fs.copy() 這樣的遞歸函數來將文件複製到"copyOfExampleFile.txt"，然後使用 fs.move() 將這個複製件重新定位到"movedExampleFile.txt"。然後使用 fs.remove() 刪除重新定位的文件。該程式使用 fs.ensureFile() 函數來檢驗"newFile.txt"的存在性，並使用 fs.writeJson() 將一個 JSON 對象寫入"data.json"文件。最後，它使用 fs.readJson() 從文件中讀取回 JSON 資料並記錄到控制台中。在這些過程中發生的任何錯誤都會被捕捉並記錄。通過調用函數 performFileOperations 順序執行這些操作，然後演示 fs-extra 在 Node.js 中用於文件和目錄管理的有用性和易用性。

輸出

fs extra npm (How It Works For Developers): Figure 3 - File explorer output displaying the exampleDir directory and files created programmatically using fs-extra library in Node.js application

結合 fs-extra 與 IronPDF

將用於可靠 PDF 生成的 IronPDF 與已改良檔案系統操作的 fs-extra 結合，形成了一個強大的 Node.js 開發者工具包。本教程將指導您使用 IronPDF 和 fs-extra 設置 Node.js 專案，並包含示例代碼來展示如何將它們一起使用。

什麼是IronPDF？

IronPDF 是一個強大的 Node.js 庫，旨在將 HTML 資料轉換為高品質的 PDF 文件。它加快了將 HTML、CSS 和其他 JavaScript 文件轉換為格式正確的 PDF 的進程，而不影響原始網頁內容。這對於需要生成動態、可打印文件（如發票、證書和報告）的 Web 應用非常有用。

IronPDF 擁有多種功能，包括可自定義的頁面設置、頁眉、頁腳以及添加字體和圖像的選項。它可以管理複雜的樣式和佈局，確保每個測試的PDF輸出都符合規格。此外，IronPDF 控制 HTML 中的 JavaScript 執行，允許準確動態和互動內容的渲染。

fs extra npm (How It Works For Developers): Figure 4 - IronPDF for Node.js: The Node.js PDF Library

IronPDF特性

從HTML生成PDF

將HTML、CSS和JavaScript轉換為PDF。支持现代网页标准，如媒體查詢和響應式設計，這在使用 HTML 和 CSS 動態裝飾 PDF 文件、報告和賬單時很方便。

PDF編輯

向現有的 PDFs 添加文本、圖片和其他材料。
從 PDF 文件中提取文本和圖片。
合併多個 PDF 為單個文件。
將 PDF 文件拆分為幾個不同的文檔。
添加頁眉、頁腳、批註和水印。

效能和可靠性

設計屬性包括在工業環境中的高性能和可靠性。它輕鬆處理大量文件集。

安裝IronPDF

要獲得在 Node.js 項目中處理 PDF 所需的工具，請安裝 IronPDF package。

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

SHELL

整合 fs-extra npm 與 IronPDF

為了演示如何將 fs-extra 和 IronPDF 一起使用，請在您偏好的文本編輯器中打開 index.js 并添加以下代碼：

// Import fs-extra and IronPDF libraries
const fs = require('fs-extra');
const IronPdf = require("@ironsoftware/ironpdf");

const document = IronPdf.PdfDocument;
var config = IronPdf.IronPdfGlobalConfig;
config.setConfig({ licenseKey: '' }); // Set your IronPDF license key here

// Asynchronous function to create and manage PDF files
async function createAndManagePDF() {
  try {
    // Ensure the parent directory exists
    const outputDir = 'output';
    await fs.ensureDir(outputDir);

    // Define the HTML content for the PDF
    const htmlContent = `
      <html>
        <head>
          <title>Sample PDF</title>
        </head>
        <body>
          <h1>Hello, world!</h1>
          <p>This is a sample PDF generated using IronPDF and fs-extra.</p>
        </body>
      </html>
    `;

    // Initialize IronPDF and generate a PDF from the HTML content
    let pdf = await document.fromHtml(htmlContent);
    const pdfPath = `${outputDir}/sample.pdf`;
    await pdf.saveAs(pdfPath);
    console.log('PDF generated successfully:', pdfPath);

    // Read the PDF file and check its size
    const pdfData = await fs.readFile(pdfPath);
    console.log('PDF file size:', pdfData.length);

    // Copy the PDF file
    const copiedPdfPath = `${outputDir}/copied_sample.pdf`;
    await fs.copy(pdfPath, copiedPdfPath);
    console.log('PDF copied successfully:', copiedPdfPath);

    // Move the copied PDF file
    const movedPdfPath = `${outputDir}/moved_sample.pdf`;
    await fs.move(copiedPdfPath, movedPdfPath);
    console.log('PDF moved successfully:', movedPdfPath);

    // Remove the original PDF file
    await fs.remove(pdfPath);
    console.log('Original PDF removed successfully:', pdfPath);
  } catch (err) {
    console.error('Error during PDF creation and management:', err);
  }
}

// Execute the PDF creation and management operations
createAndManagePDF();

// Import fs-extra and IronPDF libraries
const fs = require('fs-extra');
const IronPdf = require("@ironsoftware/ironpdf");

const document = IronPdf.PdfDocument;
var config = IronPdf.IronPdfGlobalConfig;
config.setConfig({ licenseKey: '' }); // Set your IronPDF license key here

// Asynchronous function to create and manage PDF files
async function createAndManagePDF() {
  try {
    // Ensure the parent directory exists
    const outputDir = 'output';
    await fs.ensureDir(outputDir);

    // Define the HTML content for the PDF
    const htmlContent = `
      <html>
        <head>
          <title>Sample PDF</title>
        </head>
        <body>
          <h1>Hello, world!</h1>
          <p>This is a sample PDF generated using IronPDF and fs-extra.</p>
        </body>
      </html>
    `;

    // Initialize IronPDF and generate a PDF from the HTML content
    let pdf = await document.fromHtml(htmlContent);
    const pdfPath = `${outputDir}/sample.pdf`;
    await pdf.saveAs(pdfPath);
    console.log('PDF generated successfully:', pdfPath);

    // Read the PDF file and check its size
    const pdfData = await fs.readFile(pdfPath);
    console.log('PDF file size:', pdfData.length);

    // Copy the PDF file
    const copiedPdfPath = `${outputDir}/copied_sample.pdf`;
    await fs.copy(pdfPath, copiedPdfPath);
    console.log('PDF copied successfully:', copiedPdfPath);

    // Move the copied PDF file
    const movedPdfPath = `${outputDir}/moved_sample.pdf`;
    await fs.move(copiedPdfPath, movedPdfPath);
    console.log('PDF moved successfully:', movedPdfPath);

    // Remove the original PDF file
    await fs.remove(pdfPath);
    console.log('Original PDF removed successfully:', pdfPath);
  } catch (err) {
    console.error('Error during PDF creation and management:', err);
  }
}

// Execute the PDF creation and management operations
createAndManagePDF();

JAVASCRIPT

上述 Node.js 代碼示例將 IronPDF 用於 PDF 文件的創建和管理，並將 fs-extra 用於先進的文件系統操作。它首先使用 fs.ensureDir() 函數確保名為"output"的目錄存在。目錄是檔案和目錄的層次組。要創建的 PDF 結構由 HTML 內容定義，並包含在 htmlContent 中。它使用 IronPDF 的 PdfDocument 类将 HTML 内容插入 fromHtml() 方法中，并使用 saveAs() 功能将生成的 PDF 保存到"output/sample.pdf"。

輸出

fs extra npm (How It Works For Developers): Figure 5 - Console output for Node.js application combining fs-extra and IronPDF libraries. 程式使用 fs-extra 程式庫進行檔案與目錄處理，而使用 IronPDF 程式庫將 HTML 內容轉換為 PDF 文檔。

fs-extra 隨後繼續進行檔案操作：fs.readFile() 獲取 PDF 的內容以跟蹤其大小。fs.copy() 將生成的"output/sample.pdf"複製到"output/copied_sample.pdf"，然後使用 fs.move() 方法將這個副本移動到"output/moved_sample.pdf"並最終刪除原始 PDF。通過 try-catch 塊進行錯誤處理，確保在執行 fs 方法或活動時出現的任何問題都能被正確捕捉和記錄。總體而言，這個配置展示了如何使用 fs-extra 增強文件操作，以及如何在 Node.js 應用中使用 IronPDF 輕鬆創建和操作 PDF。

輸出 PDF

fs extra npm (How It Works For Developers): Figure 6 - Output PDF generated using IronPDF and fs-extra: moved_sample.pdf

結論

最後，fs-extra 與 IronPDF 結合為 Node.js 應用中的檔案系統操作與 PDF 生成提供了堅實的解決方案。憑藉其改進的方法，fs-extra 簡化了創建目錄、複製、移動和刪除文件等任務，並建立了高效文件管理的穩固基礎。與此同時，IronPDF 提供了靈活的文件創建和處理功能，允許 HTML 內容輕鬆轉換為 PDF 檔案。

這些庫結合在一起，使開發者能輕鬆創建能夠處理和操作 PDF 文件的動態應用程式。 fs-extra 和 IronPDF 的整合使開發者能夠在 Node.js 環境中滿足多樣的文件處理需求，無論是創建發票、報告還是動態檔案，皆擁有強大的能力。

在 IronPDF 和 Iron Software 的幫助下，您可以擴展您的 Node 開發工具包，加入 OCR、條碼掃描、PDF 生成、Excel 交互及其他多種功能。 Iron Software 提供了高度可配置的系統和一系列社區支持的插件，使開發者能更快速地創建功能與網站應用程序。

IronPDF 提供了詳細的文檔，並且授權選項從 $799 這樣的計劃開始，使開發者能輕鬆選擇最適合專案需求的模型。這些功能使開發者能夠有效地解決各種問題。

客人：Engage Elephant