如何在GitHub仓库中以Git Submodule分发并使用Ruby Gem及依赖？

没问题！这种把ronn和它的Gem依赖都通过Git Submodule打包成零安装独立工具的思路完全可行，我来给你拆解具体的实现步骤：

1. 先把依赖Gem添加为Git Submodule #

咱们先在项目里建一个专门存放本地Gem的目录，比如local_gems，然后把hpricot、mustache、rdiscount逐个加为submodule：

mkdir -p local_gems
cd local_gems

# 添加各个Gem的Git仓库（用官方仓库地址即可）
git submodule add https://github.com/hpricot/hpricot.git
git submodule add https://github.com/mustache/mustache.git
git submodule add https://github.com/davidfstr/rdiscount.git

# 回到项目根目录提交配置
cd ..
git add .gitmodules local_gems
git commit -m "Add ronn's Gem dependencies as Git submodules"

2. 让Ruby优先加载本地Gem的两种方法 #

Ruby靠$LOAD_PATH变量查找库文件，咱们只需要把本地Gem的lib目录加到这个路径最前面，就能让解释器优先用本地版本，而不是系统全局的Gem。

方法一：修改ronn的可执行文件（推荐） #

直接编辑项目里ronn的bin/ronn，在shebang行（就是#!/usr/bin/env ruby那行）之后添加这段代码：

# 加载本地Gem依赖的lib目录
local_gems_dir = File.expand_path('../../local_gems', __FILE__)
%w[hpricot mustache rdiscount].each do |gem_name|
  lib_path = File.join(local_gems_dir, gem_name, 'lib')
  $LOAD_PATH.unshift(lib_path) if File.directory?(lib_path)
end

这样每次运行bin/ronn时，Ruby都会自动优先找你的本地Gem，不用额外配置环境变量。

方法二：用环境变量临时指定（无需改源码） #

如果你不想碰ronn的原代码，可以在运行前设置RUBYLIB环境变量，把本地Gem的lib目录加进去：

# 在项目根目录执行
export RUBYLIB="./local_gems/hpricot/lib:./local_gems/mustache/lib:./local_gems/rdiscount/lib:$RUBYLIB"
./path/to/ronn/bin/ronn your_markdown_file.md

这种方式适合需要临时切换依赖版本的场景。

3. 验证依赖是否正确加载 #

可以写个小脚本测试一下，确保本地Gem能被正常加载：

# 项目根目录创建test_load.rb
local_gems_dir = File.expand_path('./local_gems')
%w[hpricot mustache rdiscount].each do |gem_name|
  lib_path = File.join(local_gems_dir, gem_name, 'lib')
  $LOAD_PATH.unshift(lib_path) if File.directory?(lib_path)
end

# 打印加载路径确认本地目录已加入
puts "当前Ruby加载路径："
$LOAD_PATH.each { |path| puts "- #{path}" }

# 尝试加载所有依赖
begin
  require 'hpricot'
  require 'mustache'
  require 'rdiscount'
  puts "\n所有依赖加载成功！"
rescue LoadError => e
  puts "\n加载失败：#{e.message}"
end

运行ruby test_load.rb，如果没有报错，就说明配置没问题了。

额外小贴士 #

• 记得在项目README里加上一句：克隆项目后请执行git submodule update --init --recursive，这样其他开发者才能拉取所有submodule依赖。
• 注意rdiscount是C扩展Gem，如果你需要跨平台分发工具，最好提前在目标平台编译好对应的.so/.dll文件，或者换成纯Ruby的Markdown解析器（比如kramdown）避免编译问题。

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