npm install docx mammoth diff fs-extra

/**
 * Word文檔差異比較工具
 * 本腳本使用Node.js比較兩個Word(.docx)文件的內容差異，并生成帶有顏色標注的比較結果文檔
 */

const fs = require('fs');
const path = require('path');
const { Document, Paragraph, TextRun, HeadingLevel, Packer } = require('docx');
const mammoth = require('mammoth');
const diff = require('diff');

/**
 * 比較兩個Word文件并生成差異報告
 * @param {string} file1Path - 第一個Word文件路徑(原始文件)
 * @param {string} file2Path - 第二個Word文件路徑(修改后的文件)
 * @param {string} outputPath - 差異報告輸出路徑
 * 
 * 技術原理：
 * 1. 使用mammoth庫提取兩個Word文檔的純文本內容
 * 2. 使用diff庫進行文本差異比較，識別添加、刪除和未更改的部分
 * 3. 使用docx庫構建新的Word文檔，用不同顏色和樣式標注差異部分
 */
async function compareWordFiles(file1Path, file2Path, outputPath) {
    try {
        // 提取兩個Word文件的文本內容
        // mammoth.extractRawText會解析docx文件的XML結構，提取所有文本內容
        const file1Content = await extractTextFromDocx(file1Path);
        const file2Content = await extractTextFromDocx(file2Path);

        // 使用diff庫比較文本差異
        // diffWords函數會將文本分解為單詞級別的差異，返回一個差異對象數組
        // 每個差異對象包含value(文本內容)和added/removed標志
        const differences = diff.diffWords(file1Content, file2Content);

        // 使用docx庫創(chuàng)建新的Word文檔
        // Document對象表示整個Word文檔，包含一個或多個sections
        const doc = new Document({
            sections: [{
                properties: {},
                children: [
                    // 文檔標題
                    new Paragraph({
                        text: "Word文檔差異比較結果",
                        heading: HeadingLevel.HEADING_1,
                        spacing: { after: 200 } // 設置段后間距(單位:twip,1/20磅)
                    }),
                    // 原始文件信息
                    new Paragraph({
                        text: `原文件: ${path.basename(file1Path)}`,
                        spacing: { after: 100 }
                    }),
                    // 修改后文件信息
                    new Paragraph({
                        text: `新文件: ${path.basename(file2Path)}`,
                        spacing: { after: 200 }
                    }),
                    // 插入差異內容段落
                    ...generateDiffParagraphs(differences)
                ]
            }]
        });

        // 將Document對象轉換為Buffer并寫入文件
        // Packer.toBuffer內部使用JSZip庫打包docx文件(本質上是ZIP格式的XML文件集合)
        const buffer = await Packer.toBuffer(doc);
        fs.writeFileSync(outputPath, buffer);
        console.log(`差異比較結果已保存到: ${outputPath}`);
    } catch (error) {
        console.error('比較過程中出錯:', error);
    }
}

/**
 * 從Word文檔中提取純文本內容
 * @param {string} filePath - Word文件路徑
 * @returns {Promise<string>} 提取的純文本內容
 * 
 * 技術原理：
 * mammoth庫解析docx文件(實際是ZIP壓縮的XML文件)，
 * 遍歷document.xml中的段落和文本節(jié)點，拼接成純文本字符串
 */
async function extractTextFromDocx(filePath) {
    const result = await mammoth.extractRawText({ path: filePath });
    return result.value;
}

/**
 * 根據差異結果生成帶有樣式標注的段落數組
 * @param {Array} differences - diff庫生成的差異數組
 * @returns {Array} 包含Paragraph對象的數組
 * 
 * 技術原理：
 * 1. 處理diff庫輸出的差異數組，每個部分可能是added/removed/unchanged
 * 2. 按換行符分割文本，確保每個段落獨立
 * 3. 為不同差異類型創(chuàng)建不同樣式的TextRun:
 *    - 新增內容: 藍色(#1800a1)、加粗
 *    - 刪除內容: 紅色(#FF0000)、刪除線
 *    - 未更改內容: 黑色(#000000)
 */
function generateDiffParagraphs(differences) {
    const paragraphs = [];
    let currentParagraph = [];

    // 遍歷每個差異部分
    differences.forEach(part => {
        // 按換行符分割文本，處理多行內容
        const lines = part.value.split('\n');
        
        lines.forEach((line, lineIndex) => {
            // 跳過空行
            if (line.trim() === '') return;
            
            let textRun;
            if (part.added) {
                // 新增內容樣式
                textRun = new TextRun({
                    text: line,
                    color: '1800a1', // 藍色表示新增
                    bold: true       // 加粗突出顯示
                });
            } else if (part.removed) {
                // 刪除內容樣式
                textRun = new TextRun({
                    text: line,
                    color: 'FF0000', // 紅色表示刪除
                    strike: true      // 刪除線表示已移除
                });
            } else {
                // 未更改內容樣式
                textRun = new TextRun({
                    text: line,
                    color: '000000'  // 黑色表示未更改
                });
            }
            
            // 將文本段添加到當前段落
            currentParagraph.push(textRun);
            
            // 如果不是最后一行，創(chuàng)建新段落
            if (lineIndex < lines.length - 1) {
                paragraphs.push(new Paragraph({
                    children: currentParagraph
                }));
                currentParagraph = []; // 重置當前段落
            }
        });
    });

    // 添加最后一個未完成的段落
    if (currentParagraph.length > 0) {
        paragraphs.push(new Paragraph({
            children: currentParagraph
        }));
    }

    return paragraphs;
}

// 使用示例
const file1 = path.join(__dirname, './word/dl_v1.docx');
const file2 = path.join(__dirname, './word/js_xg_v1.docx');
const output = path.join(__dirname, './word/comparison_result.docx');

// 執(zhí)行比較
compareWordFiles(file1, file2, output);