Arctic Admin开发环境报SassC::SyntaxError，样式导入失败求助

问题背景 #

已按照arctic_admin官方文档完成以下配置：

• Gemfile中添加：

  gem 'arctic_admin'
  

• /app/assets/javascripts/active_admin.js中添加：

  //= require arctic_admin/base
  

• /app/assets/stylesheets/active_admin.scss中添加：

  @import "arctic_admin/base";
  

• active_admin.rb中配置：

  meta_tags_options = { viewport: 'width=device-width, initial-scale=1' }
  config.meta_tags = meta_tags_options
  config.meta_tags_for_logged_out_pages = meta_tags_options
  

本地环境主题运行正常，但开发环境抛出错误：

SassC::SyntaxError in ActiveAdmin::Devise::Sessions#new
Showing /usr/local/bundle/gems/activeadmin-2.12.0/app/views/layouts/active_admin_logged_out.html.erb where line #12 raised:

Error: File to import not found or unreadable: arctic_admin/base.
        on line 1:1 of app/assets/stylesheets/active_admin.scss
>> @import "arctic_admin/base";

解决方案 #

1. 确认gem安装状态 #

在开发环境执行以下命令，确保arctic_admin已被正确安装并加载：

bundle install

若使用Docker等容器化部署，需确认镜像构建阶段已执行bundle install，且本地目录挂载未覆盖gem安装路径。

2. 配置资产扫描路径 #

在config/application.rb中添加资产路径配置，确保Rails能找到arctic_admin的资产文件：

config.assets.paths << Rails.root.join('vendor', 'assets', 'stylesheets')
config.assets.paths << Rails.root.join('vendor', 'assets', 'javascripts')

arctic_admin的样式和脚本默认安装在vendor/assets目录，添加路径后Rails资产管道可扫描到这些文件。

3. 清理资产缓存 #

清理Rails临时文件和资产缓存，避免旧缓存导致的路径异常：

rails assets:clean
rails tmp:clear

4. 开发环境预编译资产（可选） #

部分容器化或特殊开发环境可能需要预编译资产才能加载，执行：

rails assets:precompile RAILS_ENV=development

注意：开发环境默认不推荐预编译，仅在常规方法无效时尝试。

5. 使用相对路径导入样式 #

若上述方法无效，尝试在active_admin.scss中使用相对路径导入：

@import "../../vendor/assets/stylesheets/arctic_admin/base";

根据实际gem安装位置调整相对路径，确保指向arctic_admin/base.scss文件。

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