更换Jekyll主题后构建/运行遇Git相关错误，需配置仓库名称

别担心，这个问题其实很好解决——jekyll-theme-primer是GitHub官方推出的主题，原本就是为GitHub Pages场景设计的，它的模板里默认集成了很多和GitHub仓库相关的功能（比如仓库链接、贡献者信息入口等），所以哪怕你是本地构建，也需要在配置文件里填上这些必要的仓库信息，不然主题模板渲染时会找不到变量报错。

下面是具体的解决步骤：

1. 在_config.yml中添加仓库配置项 #

打开你的站点根目录下的_config.yml文件，添加以下内容：

# GitHub相关配置（primer主题必需）
repository: your-username/your-repo-name  # 比如 blkpingu/my-personal-site
github_username: your-github-username    # 比如 blkpingu

• 如果你还没有对应的GitHub仓库，随便填一个占位值就行（比如test-user/test-repo），本地构建时主题只会用这些值渲染模板，不会验证仓库是否真实存在。
• 如果你已经有GitHub仓库，直接填实际的用户名和仓库名即可，这样后续部署到GitHub Pages时也能正常生效。

2. 验证配置并重新构建 #

保存_config.yml后，重新运行构建命令：

jekyll serve

这时候应该就能正常启动本地服务，不会再提示“配置仓库名称”的错误了。

补充说明 #

之前用minima主题没有这个问题，是因为minima是Jekyll的通用默认主题，不依赖任何平台特定的配置，而primer主题深度绑定了GitHub Pages的生态，所以才有这个特殊要求。另外，迁移后你可以检查一下页面的front matter，确保使用的是primer主题支持的布局（比如layout: default，primer主题的默认布局已经适配了它的组件样式）。

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