如何用NPOI的XSSFRichTextString/XSSFHyperlink实现Excel单元格部分文本超链接？

要实现单元格内仅部分文本带超链接的效果，Apache POI的XSSF需要通过操作底层OOXML对象来完成，因为XSSFRichTextString的高层API没有直接暴露该功能。以下是具体实现代码：

import org.apache.poi.xssf.usermodel.*;
import org.openxmlformats.schemas.spreadsheetml.x2006.main.*;

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

public class PartialHyperlinkCell {
    public static void main(String[] args) throws IOException {
        // 创建工作簿和工作表
        XSSFWorkbook workbook = new XSSFWorkbook();
        XSSFSheet sheet = workbook.createSheet("Sheet1");
        XSSFRow row = sheet.createRow(0);
        XSSFCell cell = row.createCell(0);

        // 创建富文本字符串
        XSSFRichTextString richText = new XSSFRichTextString("点击此处查看详情");

        // 获取富文本的底层CTR对象
        CTR ctr = richText.getCTR();
        
        // 拆分文本片段：点击 + 此处（带链接）+ 查看详情
        CTR rNormal1 = ctr.addNewR();
        rNormal1.setT("点击");

        // 为"此处"配置超链接和样式
        CTR rLink = ctr.addNewR();
        rLink.setT("此处");
        CTRPr rpr = rLink.addNewRPr();
        
        // 设置超链接样式：蓝色、单下划线
        CTColor color = rpr.addNewColor();
        color.setRgb(new byte[]{0x00, 0x00, (byte)0xFF});
        rpr.addNewU().setVal(STUnderline.SINGLE);
        
        // 创建并关联超链接
        CTHyperlink hyperlink = rLink.addNewHyperlink();
        XSSFHyperlink xssfHyperlink = workbook.getCreationHelper().createHyperlink(XSSFHyperlink.LINK_URL);
        xssfHyperlink.setAddress("https://test.com");
        
        // 注册超链接关系到工作簿
        int rId = workbook.getPackagePart().addRelationship(
            xssfHyperlink.getAddress(), 
            XSSFRelation.SHEET_HYPERLINKS, 
            null
        ).getId();
        hyperlink.setId(rId);

        // 添加剩余文本
        CTR rNormal2 = ctr.addNewR();
        rNormal2.setT("查看详情");

        // 将富文本设置到单元格
        cell.setCellValue(richText);

        // 调整列宽适配内容
        sheet.autoSizeColumn(0);

        // 写入文件
        try (FileOutputStream fos = new FileOutputStream("partial_hyperlink.xlsx")) {
            workbook.write(fos);
        }
        workbook.close();
    }
}

关键说明： #

• 仅XSSF（.xlsx格式）支持该功能，HSSF（.xls旧格式）不支持单元格内部分文本超链接。
• 必须直接操作OOXML的CTR、CTHyperlink等底层对象，因为Apache POI高层API未封装此功能。
• 手动设置超链接的蓝色下划线样式，才能呈现默认超链接的视觉效果。
• 超链接ID必须与工作簿中注册的关系ID匹配，否则跳转功能无效。

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