Jekyll主题仅本地生效 远程部署后无法正常加载问题求助

问题原因 #

本地Jekyll运行环境会加载你本地已安装的所有第三方主题、插件，但是GitHub Pages的线上运行环境为沙箱模式，仅默认启用白名单内的插件，也不会读取你本地安装的非官方支持主题。你遇到的本地正常、线上无样式的问题，核心是线上环境未成功拉取到主题资源，或静态资源请求路径错误返回404。

解决步骤 #

• 修正_config.yml路径配置：你使用的是<username>.github.io类型的根站点，baseurl字段需留空，url字段填写你的完整站点域名即可。
• 补全远程主题依赖配置：如果使用的主题不在GitHub Pages官方支持列表内，仅修改theme为remote_theme无法生效，需要同时做两个配置：
  1. 在Gemfile中添加依赖：gem "jekyll-remote-theme"
  2. 在_config.yml的plugins列表中添加项：- jekyll-remote-theme
• 统一静态资源引用规则：所有css、js、图片的引用都需要添加Jekyll路径变量前缀，示例格式为{{ '/assets/css/style.css' | relative_url }}，不要硬写固定绝对路径，避免本地和线上路径层级不匹配。

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