You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Hexo博客GitHub部署失败:chic主题无法找到求助

解决Hexo部署到GitHub Pages后Jekyll报错找不到chic主题的问题

核心原因

GitHub Pages默认会自动启用Jekyll构建,但你已经通过Travis CI完成了Hexo的静态文件构建并部署到master分支,此时Jekyll会尝试解析静态文件目录,而静态文件中并不存在Jekyll所需的chic主题(你用的是Hexo版本的chic主题,和Jekyll主题不兼容),因此报错。

解决方案

  • 在Hexo源码所在的hexo分支根目录创建空的.nojekyll文件,这个文件会告诉GitHub Pages跳过Jekyll构建流程。
  • 检查Travis CI配置文件(.travis.yml),确保部署逻辑会将.nojekyll文件同步到master分支的根目录。如果使用Hexo自带的部署命令,Hexo会自动将源码中的.nojekyll复制到构建产物目录;如果是自定义部署脚本,需手动添加文件同步步骤。
  • 进入GitHub仓库的Settings→Pages页面,确认源分支选择的是master分支,且未配置额外的Jekyll构建选项。
  • 重新触发Travis CI构建,或手动推送.nojekyll文件到hexo分支,等待Travis完成部署。

额外说明

你之前尝试的remote_theme是Jekyll主题的配置方式,和Hexo主题完全不兼容,无需保留该配置,避免混淆构建逻辑。

内容的提问来源于stack exchange,提问作者muse0

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.08 14:40:34