【Ruby】gsubとは？使い方や活用シーンを初心者向けにわかりやすく解説

プログラミング言語•
Ruby

はじめに

Rubyのプログラミングでは、文字列を扱う機会が多いのではないでしょうか。
特に、同じ処理を複数個所に適用したり、特定の文字やパターンをまるごと書き換えたりする場面は少なくありません。
そんなときに重宝するのが、gsub メソッドです。
gsubを活用すると、正規表現や単純な文字列指定を使って、置き換え処理を簡潔に記述できます。

しかし、初心者の方は「gsubって何ができるの？」「subとの違いは？」「正規表現をどう書いたらいいの？」という疑問を持ちやすいように思います。
ここでは、Ruby初心者でも理解しやすいように、gsubの基本から実務での活用シーンまで順を追って解説していきます。

この記事を読むとわかること

  • gsubメソッドの基本構文 と subとの違い
  • 正規表現を使った置き換え時の よくある書き方 とポイント
  • ブロックやハッシュを使った 高度なgsubの応用テクニック
  • 実務での活用例や 注意点

これらを通じて、Rubyの文字列処理全般に対する理解が深まるはずです。
初心者でも、なるべく難しい言葉を使わずに説明しますので、ぜひ気軽に読み進めてみてください。

gsubメソッドの基本

gsubは、文字列の特定パターンをすべて置き換えるメソッドです。
似たメソッドとしては、1箇所だけ置き換えるsubもあります。
両者の違いを簡単にまとめると、次のようになります。

  • sub ：マッチした最初の1箇所だけを置き換える
  • gsub ：マッチしたすべての箇所を置き換える

たとえば、次のような例を見てみましょう。

text = "Rubyは楽しい。Rubyは柔軟性がある。"
puts text.sub("Ruby", "Python")
# => Pythonは楽しい。Rubyは柔軟性がある。

puts text.gsub("Ruby", "Python")
# => Pythonは楽しい。Pythonは柔軟性がある。

1行目のsubでは、最初の“Ruby”のみが“Python”に置き換わっています。
一方gsubを使うと、すべての“Ruby”が“Python”に置き換わります。
このように、gsubは「文字列全体」にわたって置き換えたいときに非常に便利です。

なぜgsubが有用なのか

初心者の方にとっては、「文字列置き換えならsubでいいじゃないか」と思われるかもしれません。
しかし、実務では同じフレーズやパターンが文中に何度も登場するケースが少なくありません。
そのような場面では、gsubを使えば一度にまとめて処理できるため、コードを短くわかりやすく書けます。

正規表現を使ったパターンマッチ

gsubでは第二引数として「置き換え文字列」を指定するだけでなく、第一引数に正規表現を使ってより複雑なパターンを指定できます。
たとえば、ピリオドや感嘆符などの句読点をすべて削除したい場合は、次のように書けます。

text = "Hello! Ruby. It's amazing, isn't it?"
result = text.gsub(/[!.,]/, "")
puts result
# => Hello Ruby It's amazing isn't it?

上記の例では、/[!.,]/ という正規表現が、文字列中にある "!" や "."、"," を一度に見つけ出して削除しています。
正規表現を使えば、単純な文字列の一致だけでなく、パターンに基づいた柔軟な検索や置換 が可能です。

よく使われる正規表現の例

正規表現の書き方を覚えるのは最初は大変かもしれません。
しかし、実務でよく使われるパターンはいくつか決まっているので、代表的なものを以下に示します。

  • \d ：数字を意味します。例：\d+ は連続する1桁以上の数字を表す
  • \s ：空白文字（スペースやタブ）を意味します
  • \w ：英数字やアンダースコアを意味します
  • . ：任意の1文字を意味します
  • ^ ：行頭を表します
  • $ ：行末を表します

これらを組み合わせて、たとえば「半角数字をすべて取り除く」「特定のパターンを置き換える」といった複雑な処理が行えます。

ブロックを使った置き換え

gsubには、文字列だけでなく ブロック を指定することで、マッチした部分ごとに動的な処理をすることもできます。
たとえば、数字が含まれた部分をすべて2倍の数字に置き換える、といったことも簡単に実現できます。

text = "りんごが3個、みかんが5個あります。"
result = text.gsub(/\d+/) do |matched|
  (matched.to_i * 2).to_s
end
puts result
# => りんごが6個、みかんが10個あります。

ここでは matched に、正規表現 /\d+/ で見つかった連続する数字が文字列として渡されます。
ブロック内ではその数字を to_i で整数に変換し、2倍にしてから再度文字列に変換して返しています。
gsubはマッチしたすべての箇所に対してブロックを実行するので、手間をかけずにまとめて処理ができます。

ブロックの活用シーン

ブロックを使うと、単純な文字列置き換えを超えた「動的な」変更が可能になります。
たとえば、以下のようなケースが考えられます。

  • 日付の書式変換
  • 英語の単語だけ大文字にする
  • 文章中のユーザーIDの箇所を「ユーザー(〇〇)」のようにラベル付けする
  • 各数字の値を何らかの計算で変更する

実務では、いわゆる「データクレンジング」や「フォーマット変換」がよくあります。
その際には、gsubにブロックを組み合わせるテクニックが非常に役立つでしょう。

gsubとハッシュによる置き換え

Rubyでは、gsubにハッシュを渡して置き換えを行う 方法もあります。
実はこれは、ブロックとは異なる記法で、文字列を変換する一つの便利な手段です。
たとえば、次のように書くことができます。

mapping = {
  "apple" => "りんご",
  "orange" => "みかん",
  "banana" => "バナナ"
}

text = "I like apple and orange but not banana."
result = text.gsub(/\b(?:apple|orange|banana)\b/, mapping)
puts result
# => I like りんご and みかん but not バナナ.

ここで注目したいのは、/\b(?:apple|orange|banana)\b/ の部分です。
これは「apple、orange、bananaのいずれかに合致する単語」を検索し、合致した部分をハッシュから探して、対応する値に置き換えます。
このようにハッシュを使えば、複数のキーワードを一気に翻訳したり、定義済みの変換表 に沿って文字列を置き換えたりできます。

なぜ便利なのか

実務では、「ある程度リストアップされた語句を一括で別のものに変換する」シチュエーションが出てきます。
単純に連続して gsub を呼び出すと処理を何度も繰り返すことになるため、ソースコードが長くなりがちです。
しかし、マッピング用ハッシュを作って1行でまとめることで、可読性が上がり、保守もしやすく なります。

実務での活用例：テンプレートの動的生成

実務でよくあるケースとして、「文中の特定のキーワードを置き換えて文章を生成する」というシーンがあります。
たとえば、ユーザー名や日付などを含んだメールテンプレートの自動生成です。

template = "こんにちは、{name}さん。{date}にお会いしましょう。"
name = "佐藤"
date = "2025/02/16"

generated_text = template.gsub(/\{(name|date)\}/) do |matched|
  case matched
  when "{name}"
    name
  when "{date}"
    date
  end
end

puts generated_text
# => こんにちは、佐藤さん。2025/02/16にお会いしましょう。

この例では単純に \{(name|date)\} という正規表現にマッチしたらブロック内で条件分岐して値を置き換えています。
実際の業務でも、メールやレポートなどのテンプレートを柔軟に生成するときにgsubは大いに役に立ちます。

レイアウトやフォーマット調整にも便利

さらに文章の区切り文字を一括で変換したり、不要な文字列をまとめて削除したりといった「仕上げ」の段階でもgsubを活用できます。
特に、外部システムから取り込んだデータが想定外の形式だったときには、先にgsubで整形してからプログラムを進めるとスムーズです。

注意点：特殊文字とエスケープ

gsubを使っていると、正規表現の中や置き換え文字列の中で「思わぬ文字」が特別な意味 を持ってしまうことがあります。
たとえば、\ （バックスラッシュ）や . （ドット）などは、正規表現で特別な役割を果たす代表例です。
単に文字列として使いたいだけの場合でも、正規表現の書き方を間違えるとエラーや意図しない動作の原因となります。

text = "フォルダはC:\\Users\\Defaultです。"
result = text.gsub("C:\\Users\\Default", "D:\\Data\\MyFiles")
puts result
# => フォルダはD:\Data\MyFilesです。

上記のような置き換えは文字列マッチであればいいのですが、もし正規表現のパターンに C:\\Users\\Default をそのまま書こうとすると、バックスラッシュがさらにエスケープされる必要があるため、"C:\\\\Users\\\\Default" のように書く必要が出てきます。
こうした細かい点を誤ると、なぜか置き換えが反応しなかったり、予期しないマッチが発生することがあります。

正規表現を使う際は、. や * などの特殊文字も意図せずにマッチの範囲を広げないよう注意しましょう。

gsubとパフォーマンス

大規模なテキストや大量のファイルに対してgsubを適用するときは、パフォーマンスに気をつける必要があります。
通常の規模であれば特に問題ありませんが、数十万行にわたるログファイルや膨大なテキストを一括処理するなら、アルゴリズムを意識しましょう。

一例として、何度も gsub を呼び出すより、一度の正規表現でまとめて置き換えできるように工夫するほうが負荷が少ないことがあります。
また、Rubyの文字列操作はメモリ確保も伴うので、大きな文字列を繰り返し生成しないように注意 すると良いでしょう。

パフォーマンスの実例

以下の例のように、複数のキーワードを繰り返しgsubで書き換えるのではなく、あらかじめ正規表現を合体させて一度に置き換えた方が高速になるケースがあります。

# 複数回gsubを呼び出す例
text = "apple orange banana"
text = text.gsub("apple", "りんご")
text = text.gsub("orange", "みかん")
text = text.gsub("banana", "バナナ")

# 正規表現をまとめる例
mapping = {"apple" => "りんご", "orange" => "みかん", "banana" => "バナナ"}
text = text.gsub(/\b(?:apple|orange|banana)\b/, mapping)

一行一行は小さな違いに見えますが、大量の行や巨大な文字列で実行すると差が出る場合があります。
あくまで、大規模データや高頻度の置換処理をする場合に意識するとよいでしょう。

便利なオプション：正規表現のフラグ

Rubyの正規表現には、大小文字を区別しない i や、マルチラインを考慮する m などのフラグがあります。
gsubで利用する際にも、必要に応じてこれらのフラグを正規表現に組み込むと便利です。

text = "Hello\nHELLO\nHello"
result = text.gsub(/hello/i, "こんにちは")
puts result
# => こんにちは
#    こんにちは
#    こんにちは

上記では i フラグを使うことで、大小文字を区別せずに“hello”を探し出して置き換えています。
こうしたフラグを組み合わせることで、置き換え条件をさらに柔軟にコントロールできます。

実務での活用例：HTMLタグの除去

ウェブ開発では、データベースや外部APIから取得したHTMLをテキスト化したい場面があるかもしれません。
その際にHTMLタグをまるごと取り除くのにも、gsubは重宝します。

html = "<p>Hello <strong>Ruby</strong> world</p>"
plain_text = html.gsub(/<[^>]+>/, "")
puts plain_text
# => Hello Ruby world

このように <[^>]+> という正規表現は、「< から始まり > で終わる任意の文字列」をマッチさせています。
ただし、HTMLを完全に正規表現のみで安全にパースするのは難しい面もあるため、単純な除去ならgsubで済ませるというくらいの使い方が多いでしょう。

HTMLタグのパースが複雑になりそうなときは、HTMLパーサーなどを使う検討も必要です。

応用例：キャプチャとグループ化

正規表現でキャプチャ（括弧()）を使うと、マッチした一部分だけを取り出して別の文字列に組み込むことができます。
gsubでもこの機能を使って、文字列を再構成することが可能です。

text = "abc-123, xyz-789"
# 例：xxxx-yyyy の形式であれば、'xxxx'を'XXXX'のように大文字化し、'-'を':'にして出力する
result = text.gsub(/([a-z]+)-(\d+)/) do |matched|
  word = $1.upcase  # キャプチャ1を大文字にする
  num  = $2         # キャプチャ2をそのまま使う
  "#{word}:#{num}"
end
puts result
# => ABC:123, XYZ:789

ここでは ([a-z]+)-(\d+) という正規表現にマッチした文字列をブロック内で再構成しています。
キャプチャした値には $1、$2 のような変数を使ってアクセスできます。
これを活用すれば、複雑なフォーマット変換も読みやすい形で行えるでしょう。

gsubのリターン値と破壊的メソッド

gsubは新しい文字列を返すメソッドであり、元の文字列は変化しません。
一方で、破壊的な操作を行う gsub! も用意されています。
gsub! を使うと、呼び出し元の文字列自体を変更する点に注意してください。

text = "Hello Ruby"
modified_text = text.gsub("Ruby", "世界")

puts text
# => Hello Ruby
puts modified_text
# => Hello 世界

# 破壊的メソッド
text = "Hello Ruby"
text.gsub!("Ruby", "世界")
puts text
# => Hello 世界

扱いを誤ると予期せぬタイミングでデータが変わってしまうことがあるため、初心者の方はgsubとgsub!の違い をまずはしっかり理解しておくと良いでしょう。

まとめ

ここまで、Rubyの文字列操作でよく使われるgsubメソッド について解説してきました。
一言で「文字列の置き換え」といっても、ブロックを使った動的変換、ハッシュを使った複数キーワードの一括変換、正規表現の活用など、さまざまな使い方があります。
実務でのデータクレンジングやテンプレート生成、ログの整形など、多くの場面で役立つでしょう。

  • gsubはすべてのマッチ部分を置き換える（subは最初の1箇所のみ）
  • 正規表現を使うと、複雑なパターンも手軽に置き換え可能
  • ブロックを使えば、マッチ箇所ごとに動的な処理が行える
  • ハッシュでの置き換えやキャプチャを使いこなすと、より表現力が増す
  • 破壊的メソッド gsub! は元の文字列を変更するため注意

初心者の方でも、基本の使い方をひとつひとつ練習していくと、文字列処理の自由度が格段に上がると思います。
特に、正規表現は慣れが必要な部分もありますが、少しずつ書き方を学んでおくと今後の開発で大いに役立つはずです。
ぜひ、いろいろなパターンを試してみて、文字列の操作に困らないプログラマーを目指してみてください。

Rubyをマスターしよう

この記事で学んだRubyの知識をさらに伸ばしませんか？
Udemyには、現場ですぐ使えるスキルを身につけられる実践的な講座が揃っています。

Rubyの人気講座ランキングを見る筆者おすすめ No.1 講座！「はじめてのRuby on Rails入門-RubyとRailsを基礎から学びウェブアプリケーションをネットに公開しよう」
プログラミング言語の新着記事をチェック

【PHP入門】初心者が押さえておきたい基礎から実務活用までをわかりやすく解説