很多时候，Hexo 主题看起来“很简单”，但一旦开始定制，要处理的细节其实不少。我的经验是：不要一上来就改 CSS，而要先确认主题结构、模板和配置加载顺序。
1. 先确认主题是否正确安装
最常见的问题不是样式问题，而是主题没有真正生效。比如：
1 | theme: archer |
如果配置写错，Hexo 会继续用默认主题，页面也就不会按预期显示。这个问题看起来“低级”，但非常常见。
2. 不要拿默认配置当最终配置
主题目录里面通常会有一个 _config.yml。如果你直接改了主题自带配置，可能会出现：
- 主题变量不生效
- 页面布局异常
- 文章列表展示不一致
尤其是恢复主题的过程中，最容易出现“改了一半，配置残留”的问题。我通常会先做一次 hexo clean，再重新生成，避免缓存带来的误判。
3. CSS 很容易“修一处，坏一处”
主题定制最容易踩坑的地方就是样式层面。比如：
- 文字颜色和背景色对比过低
- 暗色模式和日间模式冲突
- 侧边栏宽度导致布局挤压
- 移动端样式覆盖了桌面端样式
这种问题很难从页面结构层面直接看出来，需要多刷新几次，并比对元素的样式来源。
4. 先保留默认，再做小步调整
我习惯的顺序是：
- 先弄清楚主题默认效果
- 再专注修改颜色和排版
- 最后再处理交互细节
这样做最大的好处是：一旦有问题，定位会更快。要知道，一个大主题里，可能有上百个样式变量，盲目修改会很快失控。
5. 生产环境要比本地更保守
在本地改动时，测试内容相对容易。真正发布时，要注意：
- 图片路径是否一致
- 站点地址是否更新
- 文章链接是否正常
- 部署分支是否正确
这类问题常常不是“主题错了”，而是配置文件和发布条件还有一层落差。
Hexo 的主题定制，最重要的是把“能用的功能”和“好看的效果”分开做。功能先稳，再做设计。