Mermaid-CLI中Gantt图工作日设置的技术解析

在Mermaid图表工具中，Gantt图是项目管理中常用的时间线可视化工具。近期有用户反馈在Mermaid-CLI中使用weekday配置项时遇到显示问题，这实际上涉及Gantt图时间轴刻度设置的完整配置逻辑。

核心问题现象

用户尝试通过JSON配置文件设置Gantt图的工作日起始点为周一：

{
    "gantt": {
        "weekday": "monday"
    }
}

但生成的图表时间轴仍默认以周日作为周起始日。这并非软件缺陷，而是配置方式需要特别注意。

技术原理剖析

Mermaid的Gantt图时间轴显示由两个关键参数共同控制：

1. tickInterval：定义时间轴刻度间隔（如1day/1week）
2. weekday：定义周起始日（monday/sunday）

这两个参数必须配合使用才能生效。在图表定义中，它们需要显式声明为指令形式：

gantt
    tickInterval 1week
    weekday monday

正确配置方案

方案一：图表内联定义（推荐）

直接在mermaid语法中声明时间轴参数：

gantt
    dateFormat YYYY-MM-DD
    tickInterval 1week
    weekday monday
    
    section 开发阶段
    需求分析 :done, des1, 2024-09-02, 5d
    系统设计 :active, des2, after des1, 3d

方案二：CLI配置文件

若需通过配置文件设置，需确保同时包含间隔参数：

{
    "gantt": {
        "tickInterval": "1week",
        "weekday": "monday"
    }
}

技术要点总结

1. 时间轴显示是复合参数控制的结果，单独设置weekday不会触发刻度重计算
2. 周起始日设置只在周粒度(1week)的时间间隔下有意义
3. 内联定义的优先级高于配置文件
4. 该设计保证了时间轴显示的灵活性，可以支持日/周/月等不同粒度的展示需求

对于需要精确控制时间轴显示的项目管理人员，建议始终明确指定tickInterval参数，这是确保时间轴按预期显示的关键所在。同时，周起始日的设置对于跨国团队尤为重要，不同地区习惯使用不同的周起始日（欧洲常用周一，北美常用周日）。