在 Plotly 的 make_subplots 中，可通过 matches 参数精准控制任意两行子图的 X 轴同步，无需全局共享，从而实现前两行数据图共用 X 轴、第三行图像子图独立缩放的灵活布局。
在 plotly 的 `make_subplots` 中，可通过 `matches` 参数精准控制任意两行子图的 x 轴同步，无需全局共享，从而实现前两行数据图共用 x 轴、第三行图像子图独立缩放的灵活布局。
当使用 make_subplots(rows=3, cols=1) 构建垂直堆叠布局（如：前两行为折线/柱状图，第三行为 type="image"）时，shared_xaxes=True 会强制所有三行子图共享 X 轴——这通常不符合需求，因为图像子图（如热力图、频谱图或自定义图像）往往需要独立的像素级或坐标系缩放逻辑。
正确的做法是显式指定匹配关系，而非依赖全局开关。Plotly 的 matches 属性正是为此设计：它允许你声明某轴（如 x2）在数据坐标空间中与另一轴（如 x）完全对齐——包括范围、自动缩放行为、分类顺序及直方图 bin 划分。
以下为完整实现步骤：
- 初始化子图时禁用全局共享（保持 shared_xaxes=False）；
- 调用 fig.update_xaxes() 分别为第 2 行 X 轴设置匹配目标（推荐让第二行跟随第一行）：
fig = make_subplots(
rows=3, cols=1,
vertical_spacing=0.05,
specs=[
[{"secondary_y": False}],
[{"secondary_y": True}],
[{"secondary_y": False, "type": "image"}]
],
subplot_titles=(plot_title_1stsubplot, plot_title_2ndsubplot),
row_heights=[0.7, 0.15, 0.15],
shared_xaxes=False, # 关键：禁用全局共享
)
# ✅ 让第 2 行的 X 轴严格匹配第 1 行（即 x 轴）
fig.update_xaxes(row=2, matches='x')
# 可选：若需反向匹配（第 1 行跟随第 2 行），则写为：
# fig.update_xaxes(row=1, matches='x2')
⚠️ 注意事项：
- matches='x' 中的 'x' 指第一行默认 X 轴 ID（Plotly 自动命名为 x, x2, x3…）；
- 图像子图（row=3）未被设置 matches，因此其 X 轴保持完全独立，支持自由 pan/zoom；
- 若后续添加 trace 到第 1 或第 2 行，只要它们使用同一 X 数据列，缩放/平移将自动同步；
- secondary_y=True 不影响 X 轴匹配逻辑，matches 仅作用于 X/Y 轴本身。
此方案兼顾灵活性与可控性，是处理混合类型子图（数据图 + 图像）时推荐的标准实践。
