GitHub Pages切换至Actions后absolute_url指向github.com问题排查

为什么url会被设为github.com？ #

• GitHub Pages经典模式会自动为Jekyll注入正确的url环境变量（即你的仓库域名my-subdomain.github.io），但切换到GitHub Actions模式后，官方starter workflow默认没有显式配置url参数。
• Jekyll在未收到明确url配置时，会尝试从构建环境的元数据中取值，最终误取到了GitHub的主域名github.com，导致absolute_url过滤器生成的链接指向了这里。
• 你提到site.base_url始终为空，这说明baseurl参数本身不影响当前问题，核心是缺失正确的url配置。

最佳修复方案 #

方案1：在Jekyll配置文件中显式指定url #

直接在项目根目录的_config.yml里添加或修改：

url: "https://my-subdomain.github.io"

这样无论本地还是GitHub Actions构建，Jekyll都会使用这个固定的url值来生成绝对链接，从根源上解决问题。

方案2：在GitHub Actions构建命令中指定url #

修改GHA工作流里的build步骤命令，添加--url参数：

bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}" --url "https://my-subdomain.github.io"

这种方式不需要修改项目配置，直接在构建阶段注入正确的url参数，适合需要根据环境动态调整的场景。

额外注意 #

如果使用自定义域名，需要在GitHub Pages的仓库设置里确认域名已正确配置，同时将url值替换为你的自定义域名（比如https://your-custom-domain.com）。

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