こんにちは!ともです。メモや原稿のテキストファイルを渡されたとき、行の頭や末尾に余分な空白が混ざっていて、そのままでは使いにくい、という場面があります。1つずつ手で直すのは件数が多いほど大変です。
この記事では、フレームワークを使わない「素のRuby」で、テキストファイルを読み込んで行頭・行末の空白を整え、行番号を付けて別ファイルへ書き出す小さな道具を作ります。Rubyという言語そのものの書き味に触れる入門作例です。
【この記事で分かること】

- Rubyで作るテキスト整形ツールの完成形
- 必要なものとコスト
- rbenvでRubyをインストールする手順
- ファイルを読み込んで、行ごとに空白を整える書き方
- 行番号を付けて、別ファイルへ書き出す書き方
- 実行コマンドと、結果の確認の仕方
【完成品のイメージ:ぐちゃっとした行が、番号付きできれいにそろう】

完成すると、コマンド1つでテキストファイルを整形できる道具が手に入ります。たとえば、次のような入力ファイルを用意します。
# 変換前の例(input.txt)
会議のメモです
次回の予定は来週
資料は事前に共有する
行頭の空白は行ごとにばらばらで、行末にも余分な空白が混ざっています。この道具に通すと、空白がそろい、行番号が付いた形で別ファイルに書き出されます。
# 変換後の例(output.txt)
1: 会議のメモです
2: 次回の予定は来週
3: 資料は事前に共有する
元のファイルは書き換えず、整形した結果を別のファイルに残す形にします。「読み込む→整える→書き出す」という、ファイル処理の基本の流れがそのまま題材です。似た題材をPythonで扱った作例もあるので、言語ごとの書き味の違いを比べてみたい場合はそちらもどうぞ。
【必要なものとコスト】

Rubyは無料で公開されているオープンソースです。自分のパソコンの中で動かす範囲では、料金はかかりません。
| 項目 | 内容 |
|---|---|
| 使うツール | Ruby/rbenv(Rubyのバージョン管理ツール)/VS Codeなどのエディタ |
| 料金の目安 | 無料(約0円) |
| 前提 | Mac、またはWSL2を用意したWindows/ターミナルの基本操作 |
バージョンの目安として、2026年11月時点でRubyの現行系列は3.4系です。この記事では、長く使える3.4系を用意します。細かなバージョンの対応は変わりやすいため、導入時に公式サイトで最新を確認してください。
【難易度と進め方の目安】

難易度は低めです。作る道具は1ファイルの短いプログラムで、フレームワークの知識は要りません。目安の所要時間は、Rubyのインストール込みで1時間前後です。
進め方は「Rubyの導入→プログラムを書く→小さなサンプルで実行→結果を確認する」の順番です。エディタはVS Codeがあると、プログラムの作成と修正がしやすくなります。
【インストール・初期設定】

Rubyの導入には、バージョン管理の道具「rbenv」経由で入れる方法を使います。パソコンに最初から入っているRubyとは別に、自分で選んだバージョンを用意できるため、あとからバージョンを切り替えるときにも困りません。Macの場合はHomebrewなどからrbenvを先に入れ、Windowsの場合はWSL2(Windowsの中でLinuxを動かす仕組み)の中で用意するのが基本です。rbenv自体の入れ方は環境で異なるため、公式の案内に沿って進めてください。
rbenvが使えるようになったら、Ruby 3.4系を入れます。バージョンは、パッチ版まで含めた完全な番号で指定するのがポイントです。
# バージョン管理の道具 rbenv で、Ruby 3.4系をインストールする(少し時間がかかる)
# バージョンは、パッチ版まで含めた完全な番号で指定する(数字は一例)
rbenv install 3.4.8
# このパソコン全体で使うRubyとして、入れたバージョンを指定する
rbenv global 3.4.8
# Rubyのバージョンを表示して確認する(3.4.8 と表示されれば用意ができている)
ruby -v
ruby -v で入れたバージョンが表示されれば、土台は動いています。違う数字が表示される場合は、rbenv global の指定を忘れていないかを確認してください。
【作り方の骨格1:ファイルを読み込んで、行ごとに空白を整える】

プログラムは text_cleaner.rb という名前のファイルに書きます。まず前半として、ファイルを読み込み、行頭と行末の空白を取り除くところまでを作ります。
# テキストファイルを読み、行頭・行末の空白を整えて、行番号を付けて別ファイルへ書き出す道具
# 使い方: ruby text_cleaner.rb input.txt output.txt
# コマンドライン引数から、入力ファイルと出力ファイルの名前を受け取る
input_file = ARGV[0]
output_file = ARGV[1]
# 入力ファイルを1行ずつ読み込む(chomp: true で、行末の改行を取り除いておく)
lines = File.readlines(input_file, chomp: true)
# 各行の行頭と行末の空白を取り除く
# 半角スペースとタブに加えて、全角スペースも対象にしている
cleaned = lines.map do |line|
line.gsub(/\A[ \t ]+|[ \t ]+\z/, '')
end
ポイントは2つです。1つ目は、入力と出力のファイル名をプログラムの中に直接書かず、コマンドライン引数(ARGV)で受け取る形にしていることです。ファイル名を外から渡せるようにしておくと、別のテキストでも同じ道具を使い回せます。
2つ目は、空白の取り除き方です。Rubyには行頭・行末の空白を取る strip という部品もありますが、これは半角の空白が中心で、全角スペースは対象になりません。日本語のテキストでは全角スペースが混ざることが多いため、ここでは gsub(置き換えの部品)で対象を明示しています。空行はそのまま空行として残ります。
【作り方の骨格2:行番号を付けて、別ファイルへ書き出す】

後半では、整えた各行に行番号を付けて、出力ファイルへ書き出します。前半の続きとして、同じファイルに書き足してください。
# 整えた行に、先頭から順番に番号を付けて、1つの文字列に組み立てる
numbered = cleaned.each_with_index.map do |line, index|
"#{index + 1}: #{line}"
end
# 組み立てた文字列を、出力ファイルへ書き出す(末尾に改行を付ける)
File.write(output_file, numbered.join("\n") + "\n")
# 完了したことを画面に表示する(書き出した行数もあわせて出す)
puts "#{output_file} に #{numbered.size} 行を書き出しました"
each_with_index は「要素と、その順番(0から始まる番号)」をセットで取り出す部品です。表示する行番号は1から始めたいので、index + 1 としています。実行はターミナルから行います。
# 道具を実行する(入力ファイル input.txt を整形して、output.txt へ書き出す)
ruby text_cleaner.rb input.txt output.txt
# 書き出された結果の中身を表示して確認する
cat output.txt
完了のメッセージが表示され、output.txt の中身が想定どおりに整っていれば完成です。元の input.txt は書き換えていないので、失敗してもやり直せます。
【つまずきやすい点】

よくあるつまずきは5つです。1つ目は、rbenv install のバージョン指定です。「3.4」のような短い指定では対象が定まらず、エラーになります。パッチ版まで含めた完全な番号(例:3.4.8)で指定してください。指定できる番号の一覧は rbenv install -l で確認できます。
2つ目は、rbenv global の指定忘れです。インストールしただけでは使うバージョンが切り替わらず、古いRubyで実行されてしまいます。ruby -v で数字を確認し、違う場合はglobalの指定と、ターミナルの開き直しを試してください。
3つ目は、ファイルが見つからないエラー(Errno::ENOENT)です。入力ファイルの名前や、コマンドを実行している場所(カレントディレクトリ)がずれていないかを確認します。道具と入力ファイルは、同じフォルダに置くのが分かりやすい形です。
4つ目は、日本語の文字化けや文字コードのエラーです。入力ファイルの保存形式がUTF-8でないと、読み込みの段階でエラーになることがあります。エディタでファイルを開き、UTF-8で保存し直してから実行してください。
5つ目は、全角スペースが取れていないケースです。前述のとおり strip だけでは全角スペースは対象外です。この記事のコードでは gsub で対象に含めていますが、書き換えた場合は対象の文字が漏れていないか確認してください。
【まとめ】

素のRubyの入門は、「rbenvでRubyを用意する→ファイルを読み込む→行ごとに整える→行番号を付けて書き出す」という流れで進みます。1ファイルの小さな道具でも、「読み込む→加工する→書き出す」というファイル処理の型は、大きな道具でも変わりません。
この先、「データをためて、画面で操作できるWebアプリ」を作りたくなったら、Rubyのフレームワークの作例が次の段階です。
Ruby on Rails入門:CRUDアプリの骨格を作る手順
なお、「自分で作るのではなく、業務の自動化そのものを相談したい」という場合は、作ってもらう選択肢もあります。
\ 業務の自動化やAI活用を、代わりに作ってほしい方はこちら /


コメント