hexo部署到github访问404
时间: 2025-01-28 18:03:26 浏览: 73
当你将Hexo博客部署到GitHub Pages遇到404错误时,通常是因为一些配置或设置出现了问题。下面是一些常见的原因及解决办法:
### 可能的原因
1. **仓库名称不符合规范**
如果你是在`<用户名>.github.io`这样的用户页面上发布站点,则你的Git库名应该与这个完全一致;对于项目页面而言,它应当位于同其他普通项目的同一级别下。
2. **分支选择不对**
GitHub Pages可以基于不同的分支构建网站,默认是`main/master` 或 `gh-pages` 分支。你需要确认你在正确的分支进行了push操作,并且该分支包含了已经生成好的静态文件(`public`目录下的内容)。
3. `_config.yml` 配置有误
检查 Hexo 的根目录下的 `_config.yml` 文件里的参数是否准确无误,特别是:
- 站点URL (`url`) 和 根路径 (`root`)
```yaml
url: https://<username>.github.io/
root: /
```
4. CNAME记录出错 (针对自定义域名)
若使用了个性化顶级域,请保证CNAME文件指向的是正确的托管服务地址。
5. 缓存导致的问题
浏览器端可能存储了一些旧版本的数据影响到了正常浏览结果,在尝试其它解决方案之前先清除缓存试试看。
6. 访问链接拼写错误
最基础但也容易忽略的一点就是检查一下浏览器地址栏里输入的具体网址有没有打字失误等低级错误。
---
如果你按照上述步骤排查仍然无法解决问题的话,建议查看 GitHub 上关于Pages的日志信息获取更详细的报错提示并进一步分析定位故障所在。
阅读全文
相关推荐



















