如何在Rails项目中查看可用文件及调试Gem中CSS文件引入？

一、查看RAILS_ROOT范围内所有可访问的SCSS文件 #

可以通过以下两种方式快速定位Gem中的SCSS文件：

• 使用Rake命令输出资产路径
  在项目根目录执行，直接列出Rails所有资产加载路径（包含Gem提供的路径）：

  rails runner "puts Rails.application.config.assets.paths"
  

  若要直接筛选出所有SCSS文件，可执行：

  rails runner "Rails.application.config.assets.paths.each { |p| Dir.glob('#{p}/**/*.scss').each { |f| puts f } }"
  

• 在Rails控制台递归遍历资产文件
  启动rails c后运行以下代码，会逐个路径列出所有SCSS文件：

  Rails.application.config.assets.paths.each do |path|
    puts "资产路径：#{path}"
    Dir.glob("#{path}/**/*.scss").each { |file| puts "  找到文件：#{file.split(path).last}" }
  end
  

二、在控制台查找文件的实际/预期位置 #

• 检查目标文件是否存在于资产路径中
  替换文件名后在控制台执行，直接返回文件的实际路径：

  target_file = "your-gem-style.scss"
  found_path = Rails.application.config.assets.paths.find { |p| File.exist?(File.join(p, target_file)) }
  puts found_path ? "文件位置：#{File.join(found_path, target_file)}" : "未找到该文件"
  

• 查看Gem的实际安装目录
  替换Gem名称后执行，确认Gem本身的文件结构是否正确：

  puts Gem.loaded_specs['your-gem-name'].full_gem_path
  

  进入该目录后，需确保SCSS文件放在app/assets/stylesheets或lib/assets/stylesheets下（这两个是Rails默认识别的Gem资产目录）。

三、额外验证步骤 #

• 确认Gem的.gemspec中正确声明了资产文件：

  s.files += Dir["app/assets/**/*", "lib/assets/**/*"]
  

• 在Rails项目的application.scss中导入时，使用相对资产路径（无需包含根目录）：

  // 若文件在lib/assets/stylesheets/your_gem/main.scss
  @import "your_gem/main";
  

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