hexo github 404 not found
时间: 2025-05-08 11:13:01 浏览: 44
### Hexo 部署到 GitHub Pages 出现 404 错误的原因分析
当通过 Hexo 将网站部署至 GitHub Pages 后访问页面显示 `404 Not Found` 的错误时,通常可能是由于以下几个原因造成的:
#### 1. **分支设置不正确**
如果在 `_config.yml` 或 `.deploy_config` 中指定的分支不是 `main` 或者与实际仓库中的默认分支不符,则可能导致无法正常加载网页。根据描述,GitHub Pages 设置中 Branch 应该设为 `main` 并保持一致[^1]。
#### 2. **域名配置问题**
当前使用的 URL 地址可能未按照预期解析到目标站点。如果自定义域名为启用状态但 DNS 解析尚未生效或者 SSL 配置存在问题,也可能引发此现象[^2]。
#### 3. **文件路径或索引缺失**
确认根目录下是否存在 `index.html` 文件以及其内容是否为空白;另外还需检查是否有其他重定向规则干扰了正常的请求处理过程[^3]。
#### 修改建议
以下是针对上述情况的具体调整方法:
- 更新您的博客项目内的 `_config.yml` 文件以匹配正确的存储库链接和分支名称:
```yaml
deploy:
type: git
repo: https://github.com/<your_username>/<your_username>.github.io.git
branch: main
```
- 若采用 SSH 方式连接而非 HTTPS ,可以替换为如下形式:
```yaml
deploy:
type: git
repo: [email protected]:<your_username>/<your_username>.github.io.git
branch: main
```
- 安装并激活 hexo-deployer-git 插件来简化发布流程[^4]:
```bash
npm install hexo-deployer-git --save
```
最后重新执行以下命令完成清理缓存、生成静态资源及推送更新操作:
```bash
hexo clean && hexo generate && hexo deploy
```
### 注意事项
等待一段时间让更改同步完毕后再尝试打开新网址查看效果如何改善。
---
阅读全文
相关推荐

















