故障排查

构建错误

• 生成前先运行 hexo clean。
• 检查 _config.yml 和 _config.solitude.yml 的 YAML 缩进。
• 临时关闭最近启用的功能。
• 确认所需插件已经安装在博客项目中。

布局问题

• 检查自定义 CSS 是否覆盖了主题变量。
• 先用少量侧边栏和首页模块测试。
• 确认图片尺寸适合当前布局。

集成问题

• 核对服务商 ID、域名和 API 地址。
• 如果服务商要求域名白名单，需要在部署域名上测试。
• 修改无关配置前，先查看浏览器控制台和网络请求。