更换Hacker主题后全新Jekyll博客空白问题求助

1. 补充Gemfile依赖 #

你的Gemfile中jekyll_plugins组未显式声明jekyll-remote-theme，虽然github-pages官方包内置了该插件，但本地构建时可能出现依赖加载异常。在group :jekyll_plugins块中添加该gem：

group :jekyll_plugins do
  gem "jekyll-feed", "~> 0.12"
  gem "jekyll-remote-theme"
end

执行bundle install更新本地依赖。

2. 完善站点URL配置 #

_config.yml中的url字段为空，Hacker主题依赖该字段生成静态资源（CSS、JS等）的绝对路径，空值会导致资源加载失败，最终页面显示空白。本地测试时可填写http://localhost:4000，部署时替换为实际域名：

url: "http://localhost:4000"

3. 检查基础页面文件 #

确保站点根目录存在index.md或index.html，并在文件头部指定Hacker主题支持的默认布局：

---
layout: default
title: 首页
---
# 欢迎访问我的博客

4. 通过构建日志定位问题 #

运行bundle exec jekyll serve时，终端会输出构建细节，重点关注以下类型的错误：

• 远程主题拉取失败（网络或版本兼容问题）
• 模板渲染错误（变量未定义、布局文件缺失）
• 静态资源路径错误（CSS/JS返回404）

按上述步骤调整后，重新启动服务即可验证是否修复页面空白问题。

内容的提问来源于stack exchange，提问作者Galen