本地运行Jekyll Agency主题遇CSS文件冲突导致样式异常求助

问题根源 #

你本地项目的assets/css/目录同时存在agency.scss和手动放置的agency.css，再加上主题内置的同名CSS资源，导致Jekyll编译时多个源文件输出到_site/assets/css/agency.css，互相覆盖，最终修改的样式被默认主题CSS覆盖，出现样式混乱、修改不生效的情况。

解决步骤 #

• 清理冗余文件：删除项目根目录assets/css/下的agency.css，只保留agency.scss。Jekyll会自动编译SCSS文件生成对应的CSS到_site目录，手动添加的CSS会和编译产物冲突。
• 规范主题配置：在_config.yml中只保留一条主题配置，推荐启用theme: raviriley/agency-jekyll-theme（本地开发用theme更稳定，remote_theme主要针对GitHub Pages场景），注释掉另一条配置，避免重复加载主题资源。
• 重置编译环境：删除项目根目录下的_site文件夹和.jekyll-cache文件夹，清空旧的编译产物和缓存。
• 重新启动服务：运行bundle exec jekyll serve，此时路径冲突警告应该消失。修改agency.scss中的样式后，页面会正常加载你的自定义样式，自动更新功能也能正常工作。

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