如何修改JFreeChart的指定文本颜色以适配Java Swing程序暗色主题

所有需要调整的文本区域，均可通过对应组件的setXXXPaint()系列方法完成颜色配置，不需要修改图表核心渲染逻辑，最新版JFreeChart与JCommon均兼容以下写法。

各区域文本调整的具体实现 #

• 坐标轴相关文本（包含轴标题、轴上刻度数值标签）
  这类文本的颜色配置入口在坐标轴对象本身，代码示例：
  Axis domainAxis = plot.getDomainAxis();
Axis rangeAxis = plot.getRangeAxis();
// 设置轴标题文本为亮白色
domainAxis.setLabelPaint(Color.WHITE);
rangeAxis.setLabelPaint(Color.WHITE);
// 设置轴刻度文本为浅灰色，适配暗底色
domainAxis.setTickLabelPaint(Color.LIGHT_GRAY);
rangeAxis.setTickLabelPaint(Color.LIGHT_GRAY);
• 图例项文本
  图例文本颜色不需要逐个图例项配置，直接从图表自带的图例对象全局设置即可：
  LegendTitle legend = chart.getLegend();
// 统一设置所有图例项的文本颜色为浅灰色
legend.setItemPaint(Color.LIGHT_GRAY);
• 图表主标题、副标题文本
  这类文本独立于图表主体存在，需要从Title对象层级设置颜色：
  // 设置主标题颜色为亮白色
chart.getTitle().setPaint(Color.WHITE);
// 批量设置所有副标题的颜色为浅灰色
for (Title subtitle : chart.getSubtitles()) {
subtitle.setPaint(Color.LIGHT_GRAY);
}
• 数据点标签（即图表上直接标注在图形元素旁的数值文本）
  这类文本的颜色绑定在对应的数据渲染器上，无法通过图表或轴层级的配置修改，代码示例：
  CategoryItemRenderer renderer = plot.getRenderer();
// 统一设置所有数据点标签的文本颜色为浅灰色
renderer.setDefaultItemLabelPaint(Color.LIGHT_GRAY);

常见踩坑提示 #

1. 不要通过修改Font对象的内置颜色字段来调整文本色，新版JFreeChart的渲染逻辑会在绘制前强制覆盖自定义Font的颜色属性，最终设置不生效，所有颜色配置必须通过对应类的setXXXPaint()方法完成。
2. 如果需要批量调整全项目所有图表的文本颜色，可以直接复用JFreeChart自带的全局主题机制，不需要逐图表逐个组件修改，示例代码：
   StandardChartTheme darkTheme = new StandardChartTheme("custom-dark");
darkTheme.setAxisLabelPaint(Color.WHITE);
darkTheme.setTickLabelPaint(Color.LIGHT_GRAY);
darkTheme.setLegendItemPaint(Color.LIGHT_GRAY);
darkTheme.setItemLabelPaint(Color.LIGHT_GRAY);
darkTheme.setTitlePaint(Color.WHITE);
ChartFactory.setChartTheme(darkTheme);
3. 完成颜色配置后不需要手动触发组件重绘，JFreeChart自带的属性变更监听器会自动关联重绘逻辑。

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