Rails 7生产环境资产预编译流程是怎样的？

在Rails 7默认配置下，资产预编译流程分为Asset Pipeline 处理本地资源和Importmaps 处理外部JS库两个核心部分，整体触发和执行逻辑如下：

1. 触发预编译命令 #

生产环境部署前，执行以下命令启动预编译：

rails assets:precompile

该命令会同时触发Asset Pipeline和Importmaps的编译流程。

2. Asset Pipeline 处理本地资产（CSS、字体、自定义JS） #

这部分负责处理app/assets目录下的本地资源：

• 源文件解析：将Sass/SCSS编译为标准CSS，若配置了Babel则将ES6+语法的自定义JS转换为浏览器兼容的JS；
• 合并与压缩：把多个关联文件合并（如application.css导入的多个样式文件），同时用css-minify压缩CSS、terser压缩JS，减少文件体积和请求数；
• 添加哈希指纹：为编译后的文件名添加唯一哈希值（如application-7f9d32.css），实现缓存失效（Cache Busting），确保用户获取最新资源；
• 输出到静态目录：最终将处理后的文件输出到public/assets目录，部署后由Nginx、Apache等web服务器直接提供。

3. Importmaps 处理外部JS库 #

针对config/importmap.rb中配置的外部JS依赖，流程如下：

• 解析映射规则：读取配置文件中的pin、pin_all_from等指令，建立逻辑名称与实际资源地址（CDN或本地文件）的映射；
• 生成importmap.json：将映射关系生成importmap.json文件，输出到public/assets目录，浏览器加载页面时会通过这个文件解析import语句对应的资源；
• 本地外部包预编译：如果使用pin_from_local将外部库下载到本地，这些文件会被处理后放入public/assets，并同步更新importmap.json中的映射路径。

4. 生产环境运行逻辑 #

• 预编译完成后，public/assets目录会被部署到服务器，web服务器直接从该目录提供静态资产，无需Rails应用实时编译；
• Rails 7默认将config.assets.compile设为false，生产环境下不会动态编译资产，必须提前完成预编译；
• 若后续修改了资产文件或importmap配置，需重新执行预编译命令再部署，否则用户无法获取更新后的资源。

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