Ruby Gem中存储数据的文件写入路径与存储方案问询

路径报错核心原因 #

你遇到的No such file or directory报错本质是写入路径的父目录不存在，Ruby不会自动创建路径中缺失的层级目录，直接写入就会触发系统调用错误。

核心疑问解答 #

• 相对路径规则：Ruby运行时的相对路径始终相对于进程当前工作目录，也就是你执行启动命令时所在的目录。如果在Rails项目根目录执行命令，工作目录就是Rails根目录，此时相对路径是相对于宿主项目的，和Gem本身的安装目录无关。
• 存储位置选择：绝对不要把用户侧数据写入Gem本身的安装目录，会出现多项目冲突、无写入权限等问题，只要路径配置正确，文件可以正常写入宿主项目目录。

适配场景的落地方案 #

你的场景分两类数据处理，分别对应不同的存储策略：

1. 临时缓存的原始API数据 #

这类数据不需要提交到项目仓库，优先选择临时存储目录：

• Rails环境下默认存到Rails.root.join('tmp', '你的Gem名称')，Rails的tmp目录本来就是设计用来存临时缓存的，默认不会纳入Git版本控制
• 非Rails环境下默认存到系统临时目录Dir.tmpdir下的Gem专属目录，避免污染用户其他目录

2. 生成的规范JSON文件 #

这类数据需要供Rails项目后续使用，建议做成可配置路径，允许用户自定义存储位置，默认可以放在Rails.root.join('public', '你的Gem名称')或者Rails.root.join('config', 'data')这类业务常用目录。

修复后的可运行代码示例 #

写文件前先递归创建父目录即可解决路径不存在的报错：

require 'fileutils'
require 'tmpdir'

# 定义缓存存储目录
def raw_cache_dir
  # 自动适配Rails环境
  if defined?(Rails.root)
    Rails.root.join('tmp', 'ruby_api_parser', 'raw_cache')
  else
    File.join(Dir.tmpdir, 'ruby_api_parser', 'raw_cache')
  end
end

# 递归创建所有父目录，已存在的目录不会重复创建
FileUtils.mkdir_p(raw_cache_dir)

# 生成完整的文件绝对路径
target_file = File.join(raw_cache_dir, 'source_api_1.json')

# 正常写入文件不会再报错
URI.open(target_file, 'wb') do |file|
  file << URI.open(fetched_data_url).read
end

进阶适配Rails项目的优化 #

可以给Gem增加配置模块，允许用户自定义存储路径，比如在Rails初始化器中配置：

# config/initializers/ruby_api_parser.rb
RubyApiParser.configure do |config|
  # 自定义原始缓存存储路径
  config.raw_cache_path = Rails.root.join('data', 'parser_cache')
  # 自定义生成的规范JSON输出路径
  config.formatted_output_path = Rails.root.join('public', 'api_data')
end

灵活性更高，可以适配不同用户的存储需求。

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