Jekyll主题本地正常运行，远程仅显示HTML内容求助

嘿，这种本地跑起来顺得不行，一推线上就“裸奔”的情况我太熟了！咱们一步步来揪出问题：

• 先查CSS路径是否踩了坑
  本地Jekyll的路径解析和线上（比如GitHub Pages）经常不一样。你可以打开线上页面按F12，切到Console面板看看有没有红色的404报错——要是有找不到的CSS文件，那肯定是路径写错了。比如你本地用/assets/css/your-style.css，但如果你的仓库是项目仓库（不是username.github.io这种根域名仓库），线上路径得加上仓库名：/你的仓库名/assets/css/your-style.css。

• 确认CSS文件有没有被Jekyll正确处理
  很多Jekyll主题用Sass/SCSS编译成CSS，如果你直接改了生成的.css文件，可能主题的构建流程会把你的修改覆盖掉！建议你看看主题的文档，是不是应该改_sass目录下的SCSS文件？另外，跑一下bundle exec jekyll build在本地生成静态文件，看看_site目录里的CSS是不是包含了你的修改——要是这里都没生效，那线上肯定也不行。

• 去看线上的构建日志
  推代码后，去仓库的Settings→Pages里找构建日志，看看有没有编译报错。比如Jekyll版本不兼容？或者某个文件找不到？GitHub Pages用的Jekyll版本可能和你本地的不一样，你可以在仓库根目录加个Gemfile.lock锁定版本，或者用bundle update对齐版本后再试试。

• 检查你的CSS选择器是不是没命中
  有时候线上页面的HTML结构和本地有点差异（比如Jekyll动态生成的类名），导致你的CSS选不中元素。打开线上页面的Elements面板，找到你要改的元素，看看它的类名、标签和本地是不是完全一致，再对比你写的CSS选择器有没有写错。

• 最后排除缓存的锅
  浏览器有时候会死死缓存旧的CSS，导致新样式不显示。按Ctrl+F5强制刷新，或者开隐私模式访问试试，说不定刷新完样式就回来了！

先从这几个方向查，应该能很快找到问题～

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