← 返回文章列表
使用 GitHub Pages 搭建极简博客

使用 GitHub Pages 搭建极简博客

更新于 Nov 5, 2025 · 创建于 Nov 5, 2025

步骤

  1. 拥有一个 GitHub 账号
  2. 按照 skills/github-pages 学习 GitHub Pages
  3. 创建一个名为 <你的用户名>.github.io 的公开仓库
  4. 确保该仓库启用了 GitHub Pages
  5. main 分支添加 _config.yml
  6. main 分支添加 index.md
  7. _posts 目录下放置 markdown 文章
  8. 确保这 3 个文件配置正确
  9. 访问你的新博客:https://<你的用户名>.github.io

常见问题

访问网站显示 404

404 错误

解决:至少在 index 文件中添加 theme frontmatter。

文章不显示

文章不显示

解决

  • 确保 _config.yml 配置了 theme
  • 确保文章文件名使用 "-" 作为分隔符
  • 注意时区是否正确