Ruby 字符串操作：gsub 与 sub 方法的区别

在 Ruby 中，字符串替换是日常开发中最常用的操作之一。sub 和 gsub 是两个最核心的替换方法，但很多初学者经常混淆它们的功能。理解这两者的差异，能帮助你写出更加精准、高效的代码。

sub 方法：替换第一个匹配项

sub 方法用于替换字符串中第一个匹配到的模式。它的名字来自 "substitute"（替代），功能如其名——只替换一次，找到即停。

基本语法

字符串.sub(正则表达式或字符串, 替换内容)

代码示例

# 替换第一个出现的 "apple"
str = "apple banana apple cherry"
result = str.sub("apple", "orange")
puts result
# 输出: "orange banana apple cherry"

# 使用正则表达式替换
str = "price is $100 and $200"
result = str.sub(/\$/, "USD ")
puts result
# 输出: "price is USD 100 and $200"

可以看到，即使字符串中有多处匹配，sub 也只替换了第一处。

gsub 方法：替换所有匹配项

gsub 方法的 g 代表 "global"（全局）。它会替换字符串中所有匹配到的模式，不会中途停止。

基本语法

字符串.gsub(正则表达式或字符串, 替换内容)

代码示例

# 替换所有出现的 "apple"
str = "apple banana apple cherry"
result = str.gsub("apple", "orange")
puts result
# 输出: "orange banana orange cherry"

# 使用正则表达式替换
str = "price is $100 and $200"
result = str.gsub(/\$/, "USD ")
puts result
# 输出: "price is USD 100 and USD 200"

所有匹配项都被成功替换，这就是 gsub 的核心价值。

核心区别对比

使用块的形式

两个方法都支持以块的形式传入替换逻辑，这在需要根据匹配内容动态计算替换值时非常有用。

str = "1 + 2 = 3"

# sub 使用块
result1 = str.sub(/\d+/) { |num| num.to_i * 10 }
puts result1
# 输出: "10 + 2 = 3"

# gsub 使用块
result2 = str.gsub(/\d+/) { |num| num.to_i * 10 }
puts result2
# 输出: "10 + 20 = 30"

块接收匹配到的字符串作为参数，你可以在块内进行任意计算和处理。

替换后仍为原字符串

需要特别注意：无论是 sub 还是 gsub，它们都不会修改原始字符串，而是返回一个新的字符串。

str = "hello world"

# sub 返回新字符串
new_str = str.sub("world", "Ruby")
puts str      # 输出: "hello world"（原字符串不变）
puts new_str  # 输出: "hello Ruby"

如果需要原地修改，可以添加感叹号 !：

str = "apple banana apple"
str.sub!("apple", "orange")
puts str  # 输出: "orange banana apple"

str = "apple banana apple"
str.gsub!("apple", "orange")
puts str  # 输出: "orange banana orange"

实际应用场景

场景一：格式化文本

# 将日期格式从 MM/DD/YYYY 转换为 YYYY-MM-DD
date = "12/25/2024"
formatted = date.gsub(/(\d+)\/(\d+)\/(\d+)/, '\3-\1-\2')
puts formatted
# 输出: "2024-12-25"

场景二：清理数据

# 移除字符串中的所有空格
phone = "138 0013 8000"
clean = phone.gsub(/\s+/, "")
puts clean
# 输出: "13800138000"

场景三：大小写转换（仅替换第一处）

# 将句子的第一个字母大写化
sentence = "hello world. how are you?"
capitalized = sentence.sub(/[a-z]/) { |c| c.upcase }
puts capitalized
# 输出: "Hello world. how are you?"

性能考量

当只需要替换一处时，优先使用 sub。因为 gsub 会扫描整个字符串，即使已经找到匹配也会继续检查剩余部分。虽然在短字符串上差异微乎其微，但在处理大量文本时，这个选择会带来可观的性能提升。

# 推荐：只替换一处时用 sub
text.sub("旧内容", "新内容")

# 推荐：需要替换多处时用 gsub
text.gsub("旧内容", "新内容")

总结

sub 和 gsub 的区别可以概括为一句话：sub 只换第一个，gsub 全部替换。根据实际需求选择正确的方法，既能保证代码逻辑的正确性，也能优化运行效率。两个方法都支持块形式和原地修改变体（带 !），灵活运用这些特性，能让你的字符串处理代码更加简洁有力。