移除自定义域名后如何重新配置GitHub Pages站点?
解决思路与建议
1. 排查资源路径问题
本地正常线上出错,核心原因大概率是路径不匹配:
- 之前用自定义域名时如果用了绝对路径(比如
/css/style.css),现在切换到带仓库名的地址后,这类路径会指向https://<username>.github.io/css/style.css,而非仓库子路径下的资源。 - 把所有CSS、JS、图片、内部链接的路径改成相对路径(比如
./css/style.css),或者带仓库名的绝对路径(比如/repository_name/css/style.css);如果页面还残留Jekyll模板标签,就用{{ site.baseurl }}/css/style.css这种方式拼接路径。
2. 确认.nojekyll文件生效
- 去仓库的「Settings → Pages」页面,检查「Build and deployment」区域的「Source」是否设为「Deploy from a branch」,且未勾选Jekyll相关自动构建选项。
- 若设置正确但仍有问题,手动触发重新部署:在仓库的「Actions」页面找到Pages工作流,点击「Run workflow」重新构建。
3. 修正_config.yml配置(若残留Jekyll模板)
如果只是移除了Jekyll内容但页面还在用Jekyll模板标签,baseurl和url必须准确:
baseurl严格等于仓库名称,比如仓库叫my-site,就写baseurl: "/my-site"(注意开头斜杠,不要加结尾斜杠)。url只需写https://<username>.github.io,无需加仓库名,多数Jekyll模板会自动拼接url和baseurl。- 修改后提交
_config.yml,等待GitHub Pages重新构建。
4. 清理硬编码的旧域名
之前用自定义域名时,页面里可能硬编码了旧域名(比如图片链接写https://old-domain.com/xxx),把这类内容全部替换成相对路径或新的默认地址路径。
5. 强制刷新GitHub Pages缓存
GitHub Pages偶尔会缓存旧内容,导致修改不生效:
- 随便修改仓库里某个文件(比如加个空格再提交),触发重新部署来强制刷新缓存。
内容的提问来源于stack exchange,提问作者no-one
相关产品推荐
相关产品推荐

