Plotly go.Figure日期轴次刻度设置报错，求正确配置方法

问题原因 #

你遇到的ValueError是因为Plotly的layout.XAxis对象并不支持直接使用minor字典参数配置次刻度——这个写法是Plotly Express的专属配置逻辑，不适用于go.Figure。

正确实现方式 #

在go.Figure中，次刻度的配置需要使用以minor_为前缀的独立参数，以下是两种可行方案：

方案一：直接通过minor_*参数快速配置

fig.update_xaxes(
    autorange=False,
    range=[start_date_dts_heatmap_prod, end_date_dts_heatmap_prod_1],
    tickfont=dict(size=tick_font_size),
    ticklabelmode="period",
    tickcolor="black",
    ticklen=10,
    # 主刻度间隔（示例：每月一个主刻度）
    dtick="M1",
    # 次刻度配置
    minor_dtick=7*24*60*60*1000,  # 每周一个次刻度（毫秒单位）
    minor_ticklen=4,
    minor_tickcolor="gray",
    minor_gridcolor="white",
    minor_griddash="dot",
    row=3, col=1
)

方案二：自定义主刻度后搭配次刻度

如果需要对主刻度的位置、标签做精细控制，可以先手动定义主刻度，再配置次刻度：

import pandas as pd

# 生成每月第一天作为主刻度
major_ticks = pd.date_range(
    start=start_date_dts_heatmap_prod, 
    end=end_date_dts_heatmap_prod_1, 
    freq='MS'
)

fig.update_xaxes(
    autorange=False,
    range=[start_date_dts_heatmap_prod, end_date_dts_heatmap_prod_1],
    tickfont=dict(size=tick_font_size),
    ticklabelmode="period",
    tickcolor="black",
    ticklen=10,
    # 自定义主刻度
    tickmode='array',
    tickvals=major_ticks,
    ticktext=[dt.strftime('%Y-%m') for dt in major_ticks],
    # 次刻度配置
    minor_dtick=7*24*60*60*1000,
    minor_ticklen=4,
    minor_gridcolor="white",
    minor_griddash="dot",
    row=3, col=1
)

核心要点 #

go.Figure的轴配置逻辑中，所有次刻度相关的属性都是独立的，比如minor_dtick（次刻度间隔）、minor_ticklen（次刻度长度）、minor_gridcolor（次网格线颜色）等，不需要包裹在minor字典中。

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