GitHub Pages构建失败：_config.yml需包含哪些必填配置？

一、解决当前构建报错 #

从日志核心错误Is a directory @ apply2files - /github/workspace/_site/assets来看，问题是Jekyll尝试操作_site/assets目录时误将其当成文件处理，按以下步骤修复：

• 排除_site目录：在仓库根目录创建或更新.gitignore文件，添加一行_site/，避免把构建生成的目录提交到仓库（GitHub Pages会自动构建生成该目录，无需手动提交）。
• 清理已提交的_site目录：如果之前误提交了_site，执行命令：

  git rm -r --cached _site
  git commit -m "Remove _site directory from repo"
  git push
  

• 重新触发构建：登录GitHub仓库，进入Actions页面，找到失败的构建任务，点击"Re-run jobs"重新执行构建。

二、_config.yml必须包含的配置项 #

GitHub Pages运行Jekyll时，以下是基础必选配置项：

• title: 站点标题，会在主题的页眉、首页等位置展示
• description: 站点描述文本，用于SEO优化及主题内的说明展示
• theme: 指定GitHub Pages官方支持的主题，比如你日志里的jekyll-theme-primer，常用的还有minima、jekyll-theme-cayman等
• github_username: 你的GitHub用户名（配合jekyll-github-metadata插件获取仓库相关信息）

示例基础配置文件 #

title: 我的个人站点
description: 记录技术学习与日常分享
theme: jekyll-theme-primer
github_username: luciennee
url: https://luciennee.github.io
baseurl: "" # 根域名站点留空，子路径站点填写如"/blog"

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