Skip to content

外观模式 (明暗)

控制站点的默认色彩模式。主题支持随系统自动切换,也支持锁定为浅色或深色。

配置位置

在站点根目录的 hugo.toml(或 config.toml)中设置:

toml
[params.theme]
  # 说明:设置首次访问时的默认模式。
  # 可选值:
  #   - 'auto'  (推荐):跟随用户系统/浏览器的明暗设置。
  #   - 'light':强制默认使用浅色模式。
  #   - 'dark' :强制默认使用深色模式。
  defaultMode = 'auto'

优先级规则

  1. 用户手动选择:如果用户点击了设置面板里的模式切换按钮,该选择会保存在浏览器的本地存储中,优先级最高。
  2. 站点配置:如果用户是第一次访问且从未手动切换过,则使用你在 hugo.toml 中设置的 defaultMode
  3. 系统默认:如果你没有进行任何配置,主题默认使用 auto