You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

移除自定义域名后如何重新配置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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.14 21:33:13