如何用Java生成含纯文本与超链接混合内容的Excel单元格？

要在同一个Excel单元格里同时包含纯文本和带超链接的文本，不能直接用普通的单元格超链接设置，得借助POI的RichTextString结合超链接对象来实现。以下是具体实现步骤和代码示例：

核心思路 #

• 使用XSSFRichTextString构建富文本内容，它支持对文本的不同片段设置不同的样式和超链接
• 为需要添加超链接的文本片段创建XSSFHyperlink对象，关联目标URL
• 给带超链接的文本设置特殊字体（蓝色、下划线，符合默认超链接视觉样式）
• 将设置好的富文本对象赋值给单元格

代码示例 #

import org.apache.poi.ss.usermodel.*;
import org.apache.poi.xssf.usermodel.*;

import java.io.FileOutputStream;
import java.io.IOException;

public class ExcelMixedContent {
    public static void main(String[] args) throws IOException {
        // 创建工作簿和工作表
        XSSFWorkbook workbook = new XSSFWorkbook();
        XSSFSheet sheet = workbook.createSheet("混合内容示例");
        
        // 创建行和单元格
        XSSFRow row = sheet.createRow(0);
        XSSFCell cell = row.createCell(0);
        
        // 构建富文本内容：纯文本 + 超链接文本
        String plainText = "查看详细文档，请访问：";
        String linkText = "POI官方文档";
        String fullText = plainText + linkText;
        
        XSSFRichTextString richText = new XSSFRichTextString(fullText);
        
        // 创建超链接对象，设置目标URL
        XSSFHyperlink hyperlink = workbook.getCreationHelper().createHyperlink(HyperlinkType.URL);
        hyperlink.setAddress("https://poi.apache.org/");
        
        // 创建带超链接样式的字体（蓝色、下划线）
        XSSFFont linkFont = workbook.createFont();
        linkFont.setColor(IndexedColors.BLUE.getIndex());
        linkFont.setUnderline(Font.U_SINGLE);
        
        // 给指定文本区间设置超链接和字体样式
        int linkStartIndex = plainText.length();
        int linkEndIndex = fullText.length();
        richText.applyFont(linkStartIndex, linkEndIndex, linkFont);
        richText.setHyperlink(hyperlink, linkStartIndex, linkEndIndex);
        
        // 将富文本赋值给单元格
        cell.setCellValue(richText);
        
        // 自动调整列宽
        sheet.autoSizeColumn(0);
        
        // 写入文件
        try (FileOutputStream outputStream = new FileOutputStream("mixed_content.xlsx")) {
            workbook.write(outputStream);
        } finally {
            workbook.close();
        }
    }
}

关键注意点 #

• 超链接的区间必须和字体样式的区间完全对应，否则会出现样式或超链接不生效的情况
• 确保使用XSSFRichTextString而非HSSFRichTextString，前者对应.xlsx格式，后者对应.xls格式
• 如果需要设置其他样式（比如加粗、字号），可以在创建字体时额外配置

内容的提问来源于stack exchange，提问作者valmarvi