快捷導(dǎo)航

Java實現(xiàn)為Word文檔添加文檔屬性

更新時間：2026年03月27日 10:51:40 作者：缺點內(nèi)向

Word文檔的文檔屬性是一組用于描述文件本身及其內(nèi)容的元數(shù)據(jù),本文以客觀方式介紹如何在Java項目中為Word文檔添加文檔屬性,包含環(huán)境準(zhǔn)備、代碼示例和注意事項,適合開發(fā)者快速上手

Word文檔的文檔屬性（Document Properties）是一組用于描述文件本身及其內(nèi)容的元數(shù)據(jù)，包括內(nèi)置屬性（如標(biāo)題、作者、主題、關(guān)鍵詞、公司等）和自定義屬性。這些屬性不會直接顯示在文檔正文中，但對文檔的搜索、分類、版本管理和協(xié)作非常有用。在Java開發(fā)中，通過Spire.Doc for Java庫可以直接操作這些屬性，無需依賴Microsoft Office環(huán)境。本文以客觀方式介紹如何在Java項目中為Word文檔添加文檔屬性，包含環(huán)境準(zhǔn)備、代碼示例和注意事項，適合開發(fā)者快速上手。

一、環(huán)境準(zhǔn)備

首先確保開發(fā)環(huán)境已安裝JDK（推薦JDK 8及以上）。Spire.Doc for Java通過JAR包或Maven依賴引入項目。

Maven引入方式（推薦）：在pom.xml中添加以下配置：

<repositories>
    <repository>
        <id>com.e-iceblue</id>
        <name>e-iceblue</name>
        <url>https://repo.e-iceblue.com/nexus/content/groups/public/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>e-iceblue</groupId>
        <artifactId>spire.doc</artifactId>
        <version>14.3.5</version>
    </dependency>
</dependencies>

若不使用Maven，可從官網(wǎng)下載Spire.Doc.jar并添加到項目classpath。引入后，即可在代碼中使用com.spire.doc包下的類。

二、添加內(nèi)置文檔屬性（Built-in Document Properties）

內(nèi)置文檔屬性是Microsoft Word預(yù)定義的固定屬性集，名稱不可更改，但值可以設(shè)置或修改。常見屬性包括Title（標(biāo)題）、Subject（主題）、Author（作者）、Company（公司）、Keywords（關(guān)鍵詞）等。

操作步驟：

創(chuàng)建Document實例并加載現(xiàn)有Word文檔（或新建空文檔）。
通過document.getBuiltinDocumentProperties()獲取BuiltinDocumentProperties對象。
調(diào)用相應(yīng)setter方法設(shè)置屬性值。
調(diào)用saveToFile()保存文檔。

完整代碼示例：

import com.spire.doc.BuiltinDocumentProperties;
import com.spire.doc.Document;
import com.spire.doc.FileFormat;

public class AddBuiltinDocumentProperties {
    public static void main(String[] args) throws Exception {
        // 創(chuàng)建Document實例并加載Word文檔
        Document document = new Document();
        document.loadFromFile("Sample.docx");  // 可替換為實際文件路徑

        // 獲取內(nèi)置文檔屬性對象
        BuiltinDocumentProperties standardProperties = document.getBuiltinDocumentProperties();

        // 設(shè)置具體屬性值
        standardProperties.setTitle("添加文檔屬性示例");
        standardProperties.setSubject("Java開發(fā)教程");
        standardProperties.setAuthor("開發(fā)者姓名");
        standardProperties.setCompany("示例公司");
        standardProperties.setManager("項目經(jīng)理");
        standardProperties.setCategory("文檔處理");
        standardProperties.setKeywords("Java, Word, 文檔屬性, Spire.Doc");
        standardProperties.setComments("本文演示如何使用Spire.Doc for Java添加內(nèi)置屬性");

        // 保存文檔，支持Docx_2013格式
        document.saveToFile("AddStandardProperties.docx", FileFormat.Docx_2013);
        System.out.println("內(nèi)置文檔屬性添加完成！");
    }
}

運行后，打開生成的AddStandardProperties.docx，在文件屬性（右鍵→屬性→詳細(xì)信息）中即可看到設(shè)置的值。

三、添加自定義文檔屬性（Custom Document Properties）

自定義文檔屬性由開發(fā)者或用戶自行定義，支持名稱自由設(shè)置，值類型包括文本（String）、日期（Date）、數(shù)字（int/long/double等）和布爾（boolean）。這在需要存儲特定業(yè)務(wù)數(shù)據(jù)（如文檔ID、審批狀態(tài)、自定義標(biāo)簽）時特別實用。

操作步驟：

創(chuàng)建Document實例并加載文檔。
通過document.getCustomDocumentProperties()獲取CustomDocumentProperties對象。
使用add(String name, Object value)方法添加屬性（value會自動識別類型）。
保存文檔。

完整代碼示例：

import com.spire.doc.CustomDocumentProperties;
import com.spire.doc.Document;
import com.spire.doc.FileFormat;

import java.util.Date;

public class AddCustomDocumentProperties {
    public static void main(String[] args) throws Exception {
        Document document = new Document();
        document.loadFromFile("Sample.docx");

        // 獲取自定義文檔屬性對象
        CustomDocumentProperties customProperties = document.getCustomDocumentProperties();

        // 添加不同類型的自定義屬性
        customProperties.add("文檔ID", 2026001);                    // 數(shù)字類型
        customProperties.add("已審核", true);                       // 布爾類型
        customProperties.add("審核人", "張工程師");                 // 文本類型
        customProperties.add("審核日期", new Date());               // 日期類型

        // 保存文檔
        document.saveToFile("AddCustomProperties.docx", FileFormat.Docx_2013);
        System.out.println("自定義文檔屬性添加完成！");
    }
}

自定義屬性同樣可在Word的“文件→信息→屬性→高級屬性→自定義”標(biāo)簽頁中查看和編輯。

四、注意事項與擴展

新建文檔 vs 加載現(xiàn)有文檔：以上示例均加載現(xiàn)有文件。若需從零創(chuàng)建文檔，可使用new Document()后直接添加Section和內(nèi)容，再設(shè)置屬性。
文件格式：推薦使用FileFormat.Docx_2013以確保兼容性；舊版.doc也可支持，但屬性操作更推薦現(xiàn)代Docx格式。
異常處理：實際項目中建議添加try-catch處理loadFromFile或saveToFile可能出現(xiàn)的IO異常。
屬性讀取與刪除：Spire.Doc for Java還提供getBuiltinDocumentProperties()/getCustomDocumentProperties()讀取值，以及remove()方法刪除屬性，開發(fā)者可根據(jù)需求擴展。
性能與兼容：操作僅針對內(nèi)存中的文檔對象，適合批量處理場景；生成的文檔可在Word 2007及以上版本正常打開。
多文檔場景：可循環(huán)處理多個文件，或結(jié)合模板生成文檔時同步設(shè)置屬性。