本文介绍两种不修改原始数据语义的前提下，在 echarts 中高亮或差异化渲染 null 值的实用方案：一种通过添加哑变量维度配合 visualmap 控制样式，另一种利用双系列叠加实现“透明占位+标签标注”的视觉效果。
在数据可视化中，null 值常被默认忽略或隐式跳过，导致图表无法传达“缺失”这一关键信息。ECharts 本身不会为 null 渲染柱状，但可通过巧妙的配置实现其显式表达——既保留原始数据完整性，又赋予缺失值可识别的视觉语义。
✅ 推荐方案：哑变量 + 双坐标轴 + 叠加系列（推荐）
该方案完全不篡改原始 null 值，而是引入一个独立的 dummy 数值维度（如设为固定非零值），并将其绑定到第二个隐藏的 x 轴上，再用 visualMap 单独控制该系列的视觉属性（颜色、透明度、亮度等）。这样，null 对应的柱子由第二系列“顶替”绘制，而主系列仍忠实反映真实数值（含空白缺口），形成语义清晰的对比。
const dataset = [
{ day: 'Mon', value: 120, dummy: 0 },
{ day: 'Tue', value: 70, dummy: 0 },
{ day: 'Wed', value: null, dummy: 50 }, // ← null 行：主系列不绘，但 dummy=50 触发第二系列渲染
{ day: 'Thu', value: 80, dummy: 0 },
{ day: 'Fri', value: null, dummy: 50 },
{ day: 'Sat', value: 110, dummy: 0 },
{ day: 'Sun', value: 130, dummy: 0 }
];
option = {
dataset: [{
dimensions: [
{ name: 'day', type: 'ordinal' },
{ name: 'value', type: 'number' },
{ name: 'dummy', type: 'number' } // 哑变量：仅用于触发空值可视化
],
source: dataset
}],
xAxis: [
{ type: 'category', position: 'bottom' }, // 主x轴：显示真实值（null 处留空）
{ type: 'category', position: 'bottom', show: false } // 辅助x轴：仅用于 dummy 系列定位
],
yAxis: {},
tooltip: { show: true },
visualMap: [
// 主系列：按 value 映射颜色（可选）
{
type: 'piecewise',
seriesIndex: 0,
show: false,
dimension: 1,
inRange: { color: ['#5470C6', '#91CC75'] }
},
// 哑变量系列：专用于 null 标识
{
type: 'piecewise',
seriesIndex: 1,
show: false,
dimension: 2,
inRange: {
color: '#999',
opacity: 0.25,
colorLightness: 0.4
}
}
],
series: [
// 主系列：正常 bar，encode y → 'value'；null 自动跳过
{
type: 'bar',
encode: { x: 'day', y: 'value' }
},
// 哑变量系列：仅在 dummy > 0 时绘制浅灰半透柱，精准对应 null 位置
{
type: 'bar',
xAxisIndex: 1,
encode: { x: 'day', y: 'dummy' }
}
]
};? 优势说明： ✅ 零污染原始数据：value 字段保持 null，下游逻辑不受影响； ✅ 精准定位：dummy 值仅在需标识 null 的行设置，避免误标； ✅ 风格可控：通过 visualMap.inRange 自由调节透明度、颜色、明暗，甚至可扩展为带文字标签（配合 label 选项）； ✅ 兼容性强：适用于所有支持 dataset 的 ECharts 图表类型（柱状图、折线图等）。
⚠️ 备选方案：布尔维度 + visualMap 分类映射
早期做法是将 null 转换为布尔标记（如 isNull: true），并作为独立维度传入 dataset，再用 piecewise visualMap 按类别控制 opacity 或 colorLightness。虽可行，但需预处理数据（将 null 显式转为 true/false），且当数据中存在 0 或其他假值时易混淆，语义不如哑变量方案严谨。
? 实践建议与注意事项
-
标签增强可读性：若需在 null 柱上显示“N/A”或“—”等文本，可在第二系列中启用 label：
series[1].label = { show: true, formatter: 'N/A', color: '#666', fontSize: 12 }; - 避免视觉干扰：哑变量系列的 y 值（如示例中的 50）应小于主系列最大值，防止遮挡或比例失真；也可统一设为 1 并通过 yAxis.scale = true 自适应。
- 响应式适配：当启用 dataset.source 动态更新时，确保 dummy 字段同步刷新，维持 null 位置一致性。
- 无障碍考量：为 null 柱补充 tooltip.formatter 自定义提示（如 "Missing data for {a0}"），提升可访问性。
通过上述方法，你不仅能“看见”缺失值，更能以专业、一致、可维护的方式将其融入数据叙事——让图表真正成为数据质量的镜子，而非过滤器。
