Ruby on Rails项目引入gem后报Sass未定义box-shadow混合宏错误如何解决

关于自定义box-shadow混合宏的说明 #

你提供的box-shadow混合宏可以作为临时补丁使用，添加位置为app/assets/stylesheets/application.scss文件的最顶部，确保在导入其他sass文件之前加载即可生效。如果你的项目使用单独的混合宏管理文件，也可以放到对应的全局混合宏文件中，再在application.scss头部导入该文件即可。

更稳定的根因解决方案 #

该报错核心原因是ActiveAdmin与bootstrap-sass的sass混合宏命名冲突，同时ActiveAdmin的内置混合宏未被正确加载到全局资产管道中，可选择以下任意方案彻底解决：

• 方案1：前后台样式分离（推荐）
  ActiveAdmin作为后台管理框架，样式不需要和前台业务样式混合加载，操作步骤如下：
  1. 打开app/assets/stylesheets/application.css（或application.scss），如果存在*= require_tree .配置，替换为按需导入前台需要的样式文件，排除active_admin.scss
  2. 打开config/initializers/active_admin.rb，添加配置config.use_assets = true，确保ActiveAdmin后台会单独加载自己的样式文件，不依赖前台的资产清单
  3. 在application.scss中显式导入bootstrap的混合宏：添加@import "bootstrap";到文件顶部，优先加载bootstrap提供的box-shadow混合宏
• 方案2：替换为ActiveAdmin稳定版
  你当前使用的是github主分支的开发版ActiveAdmin，存在内置样式兼容问题，修改Gemfile中的activeadmin配置为稳定版：

  gem 'activeadmin', '~> 2.13.1'
  

  执行bundle install后重启服务即可，稳定版已内置兼容的box-shadow混合宏，不会出现未定义报错
• 方案3：调整资产加载顺序
  如果你需要在前台同时使用ActiveAdmin的样式，修改application.scss的导入顺序，把@import "active_admin/mixins";放到所有其他导入语句的最顶部，确保混合宏优先加载，再导入其他sass文件。

将application改为default相当于放弃加载自定义业务样式，仅能临时避免报错，但会丢失所有前台自定义样式；给导入路径加.css后缀会让sass将对应文件作为普通css处理，不会解析文件中定义的混合宏，因此无法解决问题。

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