Butterfly主题需通过inject.head插入完整标签且路径以/开头；Fluid主题直接配置custom_css数组，路径相对source/且不加/；Next主题推荐用source/css/_custom/custom.styl或inject注入。

Butterfly 主题：在 _config.butterfly.yml 里加 inject.head

Butterfly 主题不支持直接写 custom_css 数组，必须用 inject 区块插入 HTML 标签。路径必须以 / 开头（如 /css/custom.css），写成 ./css/custom.css 或相对路径会 404。

常见错误现象：net::ERR_ABORTED 404、样式完全不生效、控制台报 Failed to load resource。

• 确保文件放在 Hexo 根目录的 source/css/custom.css，不是 themes/butterfly/source/css/
• inject.head 下每一项是完整 <link> 标签字符串，不能只写路径
• 建议加版本号防缓存：<link rel="stylesheet" href="/css/custom.css?v=20260424">
• 多个 CSS 文件就写多行，每行一个 - 开头的字符串

Fluid 主题：配置 custom_css 数组即可

Fluid 主题原生支持 custom_css 字段，直接写路径数组就行，不需要手写 HTML 标签，更轻量也更安全。

常见错误现象：配置后无效果，其实是路径写错了——它要求的是相对于 source/ 的路径，且开头不能带 /。

立即学习“前端免费学习笔记（深入）”；

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

• 正确写法：custom_css: ["/css/custom.css"]（注意引号和斜杠）
• 错误写法：custom_css: ["source/css/custom.css"] 或 custom_css: ["css/custom.css"]
• 如果用了 CDN 字体等外部资源，也支持写完整 URL："//at.alicdn.com/t/font_1736178_ijqayz9ro8k.css"
• 修改后必须执行 hexo clean && hexo g，否则旧缓存可能掩盖变更

Next 主题：走 _custom/custom.styl 或主题配置注入

Next（v7+）推荐优先用 source/css/_custom/custom.styl，因为它是 Stylus 编译流程的一部分，能访问主题变量、函数（比如 hexo-config()），比纯 CSS 更灵活。

但如果你只想快速挂载一个现成的 CSS 文件（比如第三方 UI 库），也可以在主题配置里手动注入：

• 路径写法同 Butterfly：inject: head: - "<link rel='\"stylesheet\"' href="%5C%22/css/xxx.css%5C%22">"
• custom.styl 中可读取配置项，实现“开关式”样式控制，比如只在启用时才渲染某段样式
• Stylus 文件修改后无需清缓存，但要确保 hexo-renderer-stylus 已安装且版本兼容
• 避免同时用两种方式改同一选择器，CSS 优先级容易失控

通用陷阱：路径、缓存与构建时机

所有主题都绕不开这三个点：文件实际位置、浏览器是否加载到新文件、Hexo 是否真把文件生成进 public/。

• 检查生成结果：运行 hexo g 后，打开 public/css/custom.css，确认文件存在且内容正确
• 浏览器强制刷新：Mac 是 Cmd+Shift+R，Windows 是 Ctrl+F5，普通 F5 不一定清掉 CSS 缓存
• 不要把自定义 CSS 放在 themes/xxx/source/ 下——那属于主题源码，下次 git pull 或重装主题就丢了
• 如果用了 CDN 或外链 CSS，注意 CSP 策略可能导致被拦截，控制台看 Refused to apply inline style 类报错

真正卡住人的往往不是语法，而是 source/ 和 public/ 之间的映射没理清，或者改了配置却忘了 hexo clean。动手前先确认文件物理位置和生成结果，比反复调样式更省时间。