hoppscotch支持五种主题切换方式：一、通过设置菜单选择背景模式；二、用ctrl+k/cmd+k调出命令面板切换；三、启用系统主题自动同步；四、url参数临时指定theme值；五、修改local storage中hoppscotch:theme键值。
如果您正在使用Hoppscotch，但界面主题不符合当前环境或视觉偏好，则可能是由于主题设置未正确应用。以下是实现深色与浅色主题切换的具体操作步骤：
一、通过设置菜单切换主题
该方法直接修改应用级主题偏好，并持久化保存至本地存储，确保下次启动时自动应用所选模式。
1、点击界面右上角的齿轮形状设置图标，打开全局设置面板。
2、在左侧导航栏中选择“外观”选项卡，或直接滚动至“主题”设置区域。
3、在“背景模式”下拉菜单中，选择深色、浅色、纯黑或系统中的一项。
4、选择后界面将立即刷新，无需手动重启或刷新页面。
二、使用快捷键快速切换
该方式绕过菜单层级，适用于高频切换场景，依赖Spotlight搜索服务实时响应用户指令。
1、按下快捷键Ctrl+K（Windows/Linux）或Cmd+K（macOS）调出快捷命令面板。
2、在输入框中键入theme或主题，触发主题相关命令匹配。
3、从下拉列表中选择“切换到深色模式”或“切换到浅色模式”选项。
4、确认执行后，CSS变量集合将动态替换，界面样式即时更新。
三、启用系统主题自动同步
该机制监听操作系统级媒体查询变化，通过matchMedia API捕获prefers-color-scheme状态，实现明暗主题的无缝跟随。
1、进入设置界面，定位至“外观”→“背景模式”。
2、选择系统选项。
3、确保操作系统已开启深色模式（Windows/macOS设置中）或已配置对应环境变量。
4、Hoppscotch将自动读取系统偏好并加载对应主题变量，例如--primary-dark-color或--primary-light-color。
四、通过URL参数临时指定主题
该方式不更改用户偏好设置，仅对当前会话生效，适合调试或演示用途，参数优先级高于本地存储值。
1、在当前Hoppscotch地址栏末尾添加查询参数：?theme=dark 或 ?theme=light。
2、按回车重新加载页面。
3、界面将强制应用对应主题，但关闭标签页后该参数失效。
4、支持的参数值包括：dark、light、black、system。
五、修改本地存储强制覆盖主题
该方法适用于设置界面不可用或UI渲染异常时，通过浏览器开发者工具直接写入主题标识符。
1、按F12打开开发者工具，切换至“Application”选项卡。
2、在左侧边栏展开“Local Storage”，选择当前Hoppscotch域名条目。
3、找到键名为hoppscotch:theme的条目。
4、双击其值字段，将其修改为：dark（深色）、light（浅色）、black（纯黑）或system（系统）。
5、刷新页面，新主题将立即生效。
