Jekyll需借助jekyll-assets插件或Webpack实现资源hash、压缩与版本控制：前者通过配置fingerprint和terser支持生产环境指纹与ES6+压缩；后者需输出至assets/目录并配合relative_url或自定义数据桥接。
HTML里引用的资源怎么让Jekyll自动加hash并压缩
Jekyll本身不带Asset Pipeline，assets/目录下的style.css或script.js默认就是原样输出，没压缩、没hash、没版本控制。想实现类似Rails Asset Pipeline的效果，得靠插件或外部工具链配合。
最常用且轻量的解法是用jekyll-assets插件（Ruby生态），它支持Sass、JS压缩、CSS内联、指纹（fingerprint）和缓存失效。但注意：它只在jekyll build时生效，jekyll serve下也需启用--watch才实时编译。
- 必须在
_config.yml中启用：plugins: ["jekyll-assets"]，不能只写gems:（旧写法已弃用） -
assets/目录必须存在，且路径区分大小写；Assets或ASSETS会导致Jekyll::Assets::Error::NoSource - 引用时别直接写
<link rel="stylesheet" href="/assets/style.css">，要用Liquid标签：{% stylesheet "style" %}或{% asset "script.js" %}
为什么{% asset "main.css" %}生成的URL没变hash
因为默认配置下jekyll-assets不开启指纹（fingerprinting）。它只在environment: production或显式设置assets: { fingerprint: true }时才重命名文件并更新引用。
常见错误是本地开发时反复改CSS却没看到hash变化——其实是预期行为，不是bug。Jekyll不会为development环境自动开fingerprint，否则每次保存都刷新URL，反而干扰调试。
立即学习“前端免费学习笔记（深入）”；
- 确认
_config.yml里有：environment: production，或assets: { fingerprint: true } - 确保
main.css实际被修改过（哪怕只加个空格），否则插件认为内容未变，复用旧hash - 检查是否误用了
{% raw %}{% stylesheet "main.css" %}{% endraw %}——扩展名不该出现在引号里，正确是{% stylesheet "main" %}
JS/CSS压缩后报错：ReferenceError或Unexpected token
这是UglifyJS或Terser在Jekyll构建时对ES6+语法处理失败的典型表现。默认jekyll-assets用的是较老的UglifyJS2，不支持const、箭头函数、可选链等现代语法。
解决方向不是降级代码，而是换压缩器。推荐配Terser：先npm install terser --save-dev，再在_config.yml里指定：
assets:
js_compressor: terser
terser: { mangle: true, compress: true }
注意：terser必须是全局可用命令，或通过node_modules/.bin/terser路径显式声明；若用Yarn，可能需设PATH=node_modules/.bin:$PATH再运行jekyll build。
用Webpack替代jekyll-assets可行吗
完全可行，而且更可控，尤其当你已有webpack.config.js或用Vue/React组件时。但关键点在于“不破坏Jekyll的路径解析逻辑”。
Webpack输出的bundle.js如果放在assets/js/，Jekyll会照常复制过去；但如果你把输出路径设成_site/assets/js/bundle.js，就绕过了Jekyll的渲染流程，Liquid标签和插件功能全部失效。
- Webpack输出目录应设为
assets/js/（与Jekyll源目录同级），让Jekyll把它当普通静态资源处理 - 在
_includes/head.html里用<script src="{{ '/assets/js/bundle.js' | relative_url }}"></script>，别用{% asset %}——它不认识Webpack产物 - Webpack的
contenthash能正常工作，但Jekyll的relative_url过滤器不会帮你重写HTML里的src，得靠html-webpack-plugin或手动维护
真正麻烦的不是打包，而是如何让Jekyll知道“这个JS文件现在叫bundle.a1b2c3.js”，而不是硬编码。这时候就得放弃纯Jekyll方案，转向jekyll-webpack-plugin或自定义生成_data/assets.json来桥接。
