PDFBox 中通过 PDAcroForm.setDefaultAppearance() 设置全局默认外观无法影响已有表单字段的文本颜色；必须为每个支持可变文本的字段（如 PDVariableText）单独调用 setDefaultAppearance() 才能生效。
pdfbox 中通过 `pdacroform.setdefaultappearance()` 设置全局默认外观无法影响已有表单字段的文本颜色；必须为每个支持可变文本的字段（如 `pdvariabletext`）单独调用 `setdefaultappearance()` 才能生效。
在 Apache PDFBox v2.x 中，表单字段（如文本框、组合框等）的外观（包括字体、字号、颜色）由其自身的 Default Appearance 字符串（/DA） 控制。虽然 PDAcroForm.setDefaultAppearance() 可设置文档级默认值，但它仅对后续动态创建的新字段生效，对已存在于 PDF 模板中的既有字段（尤其是 AcroForm 表单域）通常不起作用——这是因为这些字段在原始 PDF 中已自带 /DA 条目，会覆盖表单级别的默认设置。
要真正改变已有字段的文本颜色（例如设为白色），必须逐个获取字段实例，并检查其类型是否支持文本样式控制。PDFBox 将可编辑文本字段抽象为 PDVariableText（继承自 PDTextField），该类提供了 setDefaultAppearance(String) 方法，可直接覆盖字段自身的 /DA 值。
✅ 正确做法如下：
PDField field = pDAcroForm.getField(fieldID);
if (field instanceof PDVariableText) {
// 关键：为具体字段单独设置 Default Appearance
((PDVariableText) field).setDefaultAppearance("/Helv 0 Tf 1 1 1 rg"); // 白色 RGB
field.setValue(replacementText);
} else {
// 非文本字段（如复选框、按钮）不支持此操作，跳过或按需处理
System.out.println("Field '" + fieldID + "' is not a text field, skipping color setup.");
}⚠️ 注意事项：
- /Helv 0 Tf 中的 0 表示自动缩放字体大小以适配字段区域，这是推荐做法；若需固定字号（如 12），请替换为 /Helv 12 Tf。
- 颜色指令必须符合 PDF 规范：
- 1 g → 灰度色（1.0 = 白色），适用于单色上下文；
- 1 1 1 rg → RGB 色（R=1, G=1, B=1 = 白色），更通用且推荐用于彩色文本；
- 1 1 1 0 k → CMYK 色（不推荐用于屏幕显示场景）；
- rg 和 k 区分大小写，rgb 或 cmyk 是无效操作符。
- 确保资源字典中已注册对应字体别名（如 /Helv）：你已在 pDAcroForm.setDefaultResources(resources) 中完成，但该步骤仍需保留，否则 /Helv 引用将失效。
- 若字段为只读（field.isReadOnly() == true）或被锁定了外观（field.isLocked() == true），setDefaultAppearance() 可能被忽略，建议提前校验字段状态。
? 补充技巧：如需统一管理多字段样式，可封装为工具方法：
private static void setFieldTextColor(PDField field, float r, float g, float b) throws IOException {
if (field instanceof PDVariableText) {
String da = String.format("/Helv 0 Tf %.3f %.3f %.3f rg", r, g, b);
((PDVariableText) field).setDefaultAppearance(da);
}
}
// 使用示例：设为白色
setFieldTextColor(field, 1.0f, 1.0f, 1.0f);
field.setValue(replacementText);总结：PDFBox 表单字段的颜色控制是字段粒度而非表单粒度的操作。放弃依赖 PDAcroForm.setDefaultAppearance() 对既有字段生效的假设，转而使用 PDVariableText.setDefaultAppearance() 进行精准设置，即可稳定实现文本颜色定制（包括白色、红色、蓝色等任意 RGB 值）。
