如何在 PDF 中替換文字

使用頁面清單時，哪些頁面會被修改？

在下面的範例中，系統會從 HTML 建立一份三頁的 PDF 檔案。 此替換內容適用於 0 和 2 這兩頁（即第一頁和第三頁）。 頁面 1（第二頁）保留原始文字不變。 頁面索引始終從 0 開始，這與 Java 的零起始陣列慣例一致。

```java :title=在多個特定頁面中替換文字 //:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-multiple-pages.java import com.ironsoftware.IronPDF.*; import com.ironsoftware.IronPDF.edit.PageSelection; import java.io.IO/Exception; import java.util.Arrays; import java.util.List;

public class App {

public static void main(String[] args) throws IOException {

    // 設定 IronPDF 授權金鑰
    License.setLicenseKey("IronPDF-MYLICENSE-KEY-1EF01");

    // 使用 CSS 換行符號將 HTML 轉為 3 頁的 PDF 檔案
    String html = &quot;<p> .NET 6 </p>&quot; +
                  &quot;<p> 這是第一頁 </p>&quot; +
                  &quot;<div style="page-break-after:> always;"></div>&quot; +
                  &quot;<p> 這是第 2 頁</p>&quot; +
                  &quot;<div style="page-break-after:> always;"></div>&quot; +
                  &quot;<p> .NET 6 </p>&quot; +
                  &quot;<p> 這是第 3 頁</p>&quot;;

    PdfDocument pdf = PdfDocument.renderHtmlAsPdf(html);

    String oldText = &quot;.NET6&quot;;
    String newText = &quot;.NET7&quot;;

    // 頁面編號從 0 開始：0 = 第一頁，2 = 第三頁
    // 頁面索引 1（第二頁）已刻意省略
    List<integer> pages = Arrays.asList(0, 2);</integer>

    pdf.replaceText(PageSelection.pageRange(pages), oldText, newText);

    pdf.saveAs(&quot;replaceTextOnMultiplePages.pdf&quot;);
}

}

請注意IronPdf 中的所有頁面索引均採用從零開始的編號方式。 頁面 `0` 為第一頁，頁面 `1` 為第二頁，以此類推。）}]

當從 HTML 建立多頁 PDF 時，請使用 [CSS `page-break-after` 屬性](https://developer.mozilla.org/en-US/docs/Web/CSS/page-break-after)來控制頁面邊界的定位。 在渲染前設定正確的[自訂紙張尺寸](https://ironpdf.com/java/examples/custom-pdf-paper-size/)與[頁面方向](https://ironpdf.com/java/examples/pdf-page-orientation/)，可確保在執行文字替換時，內容位置符合您的預期。 儲存後，請開啟 PDF 檔案並確認僅目標頁面有所變更，以驗證輸出結果。

### 翻譯成果應呈現何種樣貌？

<iframe loading="lazy" src="/static-assets/ironpdf-java/howto/find-replace-text/replaceTextOnMultiplePages.pdf" width="100%" height="400px"></iframe>

<hr>

## 有哪些頁面選取選項可用？

`PageSelection` 類別提供靜態工廠方法，涵蓋所有常見的目標設定模式。 無需建立實例； 直接在類別上呼叫方法。 所有索引均以零為起點。

### 哪些方法適用於單一頁面，哪些適用於多頁？

<table class="content__data-table" data-content-table>
<caption>replaceText API 的 PageSelection 工廠方法</caption>

| 方法 | 描述 |
|---|---|
| `PageSelection.allPages()` | 選取文件中的每一頁 |
| `PageSelection.firstPage()` | 選取索引頁面 `0` |
| `PageSelection.lastPage()` | 無論文件長度如何，皆選取最後一頁 |
| `PageSelection.singlePage(int pageIndex)` | 透過零起始索引選取特定頁面 |
| `PageSelection.pageRange(int startIndex, int endIndex)` | 選取從 `startIndex` 到 `endIndex`（含）的連續區間 |
| `PageSelection.pageRange(List<Integer> pageList)` | 選取任意索引組所對應的頁面（例如，`[0, 2]` 會選取第 1 頁和第 3 頁） |

</table>

### 何時該使用哪種 PageSelection 方法？

`allPages()` 是執行全域搜尋與替換的最簡便選擇：只需一次呼叫，即可將整份文件中所有目標文字的出現處一併替換。 請使用 `firstPage()` 或 `lastPage()` 進行快速編輯，以處理封面頁或最後一頁的頁尾，同時不影響正文內容。 當文字出現在章節或節等連續頁面中時，請選擇 `pageRange(int, int)`。 當目標頁面非連續時，請使用 `pageRange(List<Integer>)`； 例如，當替換僅出現在第 1、3 和 7 頁的版本字串時。

處理[合併](https://ironpdf.com/java/examples/split-pdfs/)的[ PDF](https://ironpdf.com/java/examples/split-pdfs/) 或包含[書籤與大綱](https://ironpdf.com/java/how-to/bookmarks/)的文件時，請先識別每個邏輯區段的頁碼範圍，再進行針對性替換，以避免意外修改共用頁首或頁尾。 [IronPDF for Java API 參考文件](https://ironpdf.com/object-reference/api/)列出了所有 `PageSelection` 重載方法，並附有完整的參數說明。

重要事項將 `replaceText` 的呼叫包裹在 try-catch 區塊中。 當在任何目標頁面中均未找到指定的搜尋文字時，此方法會拋出執行時例外。 驗證步驟（提取文字並確認字串存在）可防止生產環境中發生意外失敗。）}]

### 如何一次替換所有頁面的文字？

`PageSelection.allPages()` 能在單次呼叫中執行全文件範圍的替換，這是進行全局標記替換最有效率的方法。 以下範例從磁碟載入 PDF 檔案，並將整份文件中所有出現的佔位符代碼進行替換：

```java :title=在所有頁面中替換文字
//:path=/static-assets/pdf/content-code-examples/how-to/find-replace-text/replace-text-all-pages.java
import com.ironsoftware.IronPDF.*;
import com.ironsoftware.IronPDF.edit.PageSelection;
import java.io.IO/Exception;
import java.nio.file.Paths;

public class App {

    public static void main(String[] args) throws IOException {

        // 設定 IronPDF 授權金鑰
        License.setLicenseKey(&quot;IronPDF-MYLICENSE-KEY-1EF01&quot;);

        // 從磁碟載入現有 PDF 檔案
        PdfDocument pdf = PdfDocument.fromFile(Paths.get(&quot;contract-template.pdf&quot;));

        // 同時在每個頁面中替換佔位符代碼
        // 這相當於針對每頁分別呼叫 replaceText
        pdf.replaceText(PageSelection.allPages(), &quot;{{VERSION}}&quot;, &quot;2.0&quot;);

        // 儲存更新後的文件
        pdf.saveAs(&quot;contract-v2.pdf&quot;);
    }
}

此模式與模板驅動的工作流程自然契合，在該流程中，相同的佔位符會出現在多個頁面的頁首、頁尾或正文中。 對於單頁文件，allPages() 與 firstPage() 會產生相同的效果。 若頁數可能在執行時變動，請優先使用 allPages()。

區分大小寫的比對會如何影響結果？

replaceText 執行精確且區分大小寫的比對。 字串 "version 1.0" 及 "VERSION 1.0" 應視為三個獨立的值。 在對從磁碟載入的文件執行替換操作之前，請透過檢視原始來源，或從 PDF 中擷取文字並以程式化方式檢查，以確認確切的大小寫格式。

如何在 PDF 表單中替換文字？

根據 PDF 規格的定義，包含互動式表單欄位的 PDF 檔案會將其文字值與文件內容流分開儲存。 replaceText 方法作用於內容流，不會修改表單欄位的值。 若要更新表單欄位內的文字，請改用 IronPDF 專用的表單建立與編輯 API。 在同一份文件中混合使用這兩種方法是安全的：表單欄位更新與內容串流替換不會相互干擾。

如何在基於範本的工作流程中更新文字？

常見的做法是維護一個包含佔位符代碼（例如 {{CUSTOMER_NAME}} 或 [INVOICE_DATE]）的 PDF 範本，並在執行時將其替換為實際值。 每個佔位符請呼叫 replaceText 一次，並使用 PageSelection.allPages() 確保替換操作涵蓋該標記出現的所有位置。 對於由 HTML 生成的文件，此工作流程同樣適用於 renderHtmlAsPdf 後接一連串的替換呼叫。 可結合 PDF 水印或背景與前景功能，在最終輸出中添加品牌標識或保密標記。