Ruby ファイル读取

JPKODA 編集部 May 10, 2026

ファイルとのインタラクション（Interaction）は、多くのプログラミングタスクにおける基礎的なステップです。Rubyプログラムは通常メモリ（Memory）上でデータを操作しますが、情報をファイルシステム（File System）に永続化したり、そこからデータを取得（Retrieve）するケイパビリティ（Capability）も非常に重要です。これにより、アプリケーション（Application）はユーザーのプレファレンス（Preference）の保存、ログイベントの記録、コンフィグレーション（Configuration）のロード、データセット（Dataset）の処理、あるいは他のプログラムとのデータ交換が可能になります。

本章では、ファイルのオープン（Open）、様々なメソッドによるコンテンツの読み込み（Read）、そしてファイルリソースのセキュアな管理方法について学習します。一時的なメモリデータを超え、永続化されたストレージ（Storage）という外部の世界との通信を開始しましょう。

1. Ruby におけるファイル I/O の理解

インプット/アウトプット (I/O) とは、コンピュータシステムと外部世界との間の通信を指します。Rubyにおいてファイル I/O と言えば、通常はディスク（Disk）上のファイルからのデータの読み込み（Reading）、またはディスクへのデータの書き込み（Writing）を意味します。

1.1 なぜファイルが必要なのか？

ファイルはデータを永続的にストレージに保存するアプローチを提供します。これは、プログラムの実行が終了したり、コンピュータがシャットダウンされた後でもデータが残り続けることを意味します。以下のようなビルド（Build）のシナリオを想像してください：

シンプルなノートアプリケーション： ユーザーのノートをファイルに保存し、後でリトリーブ（Retrieve）できるようにする必要があります。
ゲーム： ゲームの進行状況、ハイスコア、またはカスタムレベルなどをファイルに保存できます。
データ処理スクリプト： 大規模なCSVファイルからデータをリード（Read）し、プロセス（Process）を実行した後、結果を別のファイルにライト（Write）する必要があるかもしれません。

Rubyにはビルトイン（Built-in）の File クラスが用意されており、ファイルシステムとインタラクトするための豊富なメソッドのセットを提供しています。File クラスは IO クラスを継承（Inherit）しているため、強力なインプット/アウトプットのケイパビリティを多数備えています。

2. ファイルのセキュアなオープンとクローズ

ファイルをリードまたはライトする前に、まずファイルをオープン (open) する必要があります。ファイルをオープンすると、Rubyプログラムとディスク上のファイルとの間にコネクション（Connection）が確立されます。ファイルの使用が終わったら、システムリソースを解放し、すべての変更（書き込みオペレーションの場合）が安全に保存されるように、ファイルをクローズ (close) することも同様に重要です。

2.1 File.open メソッド

ファイルをオープンする主要なメソッドは File.open です。これは少なくとも2つのパラメータ（Parameter）を受け取ります：ファイルのパス（Path）と、ファイルをオープンする際のモード (Mode) です。

読み込みオペレーションにおいて、最も一般的なモードは "r" (Read) です。

# サンプル：読み込みのためにファイルのオープンを試みる
# このアプローチはファイルを手動でクローズする必要があるため、通常は【非推奨】です。
# その理由はすぐに説明します。
file_handle = File.open("my_data.txt", "r") # 'my_data.txt' をリードオンリー（読み取り専用）モードでオープンする

# ... ここで file_handle に対するオペレーションを実行する ...

file_handle.close # 必ず手動でファイルをクローズしなければならない

2.2 なぜファイルのクローズがそれほど重要なのか？

ファイルがオープンされると、オペレーティングシステム（OS）はこのコネクションを管理するためにリソース（ファイルディスクリプタ等）をアロケート（Allocate）します。大量のファイルをオープンしたままクローズするのを忘れると、これらのリソースが枯渇し、プログラムのエラー（Error）やシステムの不安定化を招く可能性があります。書き込みオペレーション（次章で紹介します）の場合、ファイルを正しくクローズしないと、データの一部がディスクに全く書き込まれないという事態を引き起こす可能性もあります。

2.3 ブロック (Block) を使用したファイルの自動クローズ

Rubyの File.open メソッドには非常にパワフルなフィーチャーがあります。それは、ブロック (Block) を受け取ることができる点です。ブロック付きで File.open をコール（Call）すると、オープンされたファイルオブジェクトがブロックに渡され（yield）ます。

最も重要な点は、ブロックの実行が完了すると、コードが正常に終了したか、途中で例外（Exception）エラーが発生したかにかかわらず、Rubyが自動的にファイルをクローズしてくれることです。これは、ファイルオペレーションをハンドリングする上で最もセキュアで推奨されるアプローチです。

# デモンストレーション用にサンプルファイルを事前に作成する
File.open("sample_read.txt", "w") do |file| # 'w' モードは書き込み用
  file.puts "これは1行目です。"
  file.puts "これは2行目です。"
  file.puts "これは3行目です。"
end

# 推奨されるプラクティス：ブロック付きの File.open を使用して読み込みを行う
File.open("sample_read.txt", "r") do |file|
  # このブロックの内部において、'file' はオープン済みのファイルオブジェクトです
  puts "ファイルが正常にオープンされました！"
  # この後のセクションで、'file' からデータを読み込む方法を学習します
end
# ブロックが終了すると、ファイルはすでに安全かつ自動的にクローズされています。
puts "ブロック終了後、ファイルは自動的にクローズされました。"

この例において、file オブジェクトは do...end ブロックの内部でのみ利用可能です。ブロックが終了した瞬間に、システムリソースは解放されます。これにより、「ファイルのクローズ忘れ」という初歩的なバグの発生を完全に防ぐことができます。

3. ファイルコンテンツの一括読み込み

Rubyには、ファイルの全コンテンツを一度にプログラムのメモリに読み込むための、シンプルでダイレクトなメソッドが用意されています。これは比較的小さなファイルには非常に便利ですが、非常に巨大なファイルに対しては、大量のRAM（メモリ）を消費するため、慎重に使用する必要があります。

3.1 File.read(path)

File.read クラスメソッドは、ファイルの全コンテンツを単一の文字列 (String) に読み込むためのショートカット（Shortcut）です。これはバックグラウンドで自動的にファイルのオープン、リード、そしてクローズを行ってくれます。

# poem.txt ファイルを準備する
File.open("poem.txt", "w") do |f|
  f.puts "太陽は山に隠れて沈み、"
  f.puts "黄河は海へと流れ込む。"
  f.puts "さらに千里の先を見渡そうと、"
  f.puts "もう一つ上の階へと登る。"
end

# "poem.txt" の全コンテンツを一度に読み込む
file_content = File.read("poem.txt")

puts "--- 完全なファイルコンテンツ ---"
puts file_content

この例では、poem.txt のすべてのテキストが file_content 文字列変数にロード（Load）されます。各行は、末尾の改行文字 (\n) も含めて、この巨大な文字列の一部となります。

3.2 File.readlines(path)

ファイルの各行を独立したエレメント（Element）として処理したい場合は、File.readlines がベストな選択肢です。これはファイル全体を読み込み、文字列の配列 (Array of Strings) をリターン（Return）します。この配列の各文字列は、ファイル内の1行（各行の末尾にある改行文字を含む）に対応します。

# ファイルコンテンツを行ごとに分割された配列として読み込む
lines_array = File.readlines("poem.txt")

puts "\n--- 行の配列として読み込まれたコンテンツ ---"
lines_array.each_with_index do |line, index|
  # .chomp を使用して各行の末尾の改行文字をリムーブし、アウトプットをクリーンにする
  puts "第 #{index + 1} 行: #{line.chomp}"
end

puts "\n--- オリジナル配列の内部構造を確認する ---"
p lines_array # 配列のエレメントの末尾に \n 改行文字が含まれていることが確認できます

メモリに関する警告：File.read と File.readlines はどちらも、ファイル全体をメモリにロードします。コンフィグレーションファイル、短いログ、または小さなデータセットであれば全く問題ありません。しかし、非常に巨大なファイル（例えば数GBサイズのファイル）の場合、このアプローチは利用可能なメモリを急速に使い果たし、プログラムのパフォーマンス低下やクラッシュ（Crash）を引き起こします。巨大なファイルを処理する際は、次のセクションで紹介する「行単位の読み込み」ストラテジー（Strategy）を採用する必要があります。

4. ファイルの行単位読み込み（巨大なファイルの高効率処理）

巨大なファイルの場合、全体をメモリにロードするのではなく、行単位で処理を行うことが極めて重要です。Rubyにはこの目標を極めて高いパフォーマンスで実現するメソッドが用意されており、巨大なログファイルのパース（Parsing）や膨大なデータセットの処理に最適です。

4.1 File.foreach(path)

File.foreach メソッドは、巨大なファイルを行単位で処理するための理想的な選択肢です。これはファイルをオープンし、一度に1行だけをリードして、その行をブロックに渡します。つまり、任意のタイミングにおいてメモリ上に存在するのは1行分のデータのみであるため、メモリ効率が非常に高くなります。ファイルのオープンとクローズも自動的にハンドリングされます。

# デモンストレーション用に巨大なログファイルを作成する（シミュレーション）
File.open("large_log.txt", "w") do |f|
  f.puts "INFO: ユーザー 'Alice' のログインに成功"
  f.puts "DEBUG: プレファレンス設定をロード中"
  f.puts "WARN: IP 192.168.1.100 からの 'Bob' のログインに失敗"
  f.puts "INFO: レポート A のデータ処理が完了"
  f.puts "ERROR: データベースへのコネクションが失われました！"
  f.puts "INFO: ユーザー 'Alice' がログアウト"
end

puts "--- large_log.txt 内の例外を検索 ---"

# File.foreach を使用して、ファイル全体をロードせずに各行を処理する
File.foreach("large_log.txt") do |line|
  if line.include?("ERROR") 
    puts "エラーを発見: #{line.chomp}"
  elsif line.include?("WARN")
    puts "警告を発見: #{line.chomp}"
  end
end

この例は、サーバーのログファイルの処理をシミュレートしています。File.foreach は各行を読み込み、ブロック内でそれが "ERROR" または "WARN" を含んでいるかチェックします。ログファイルが数百万行あろうとも、このアプローチがメモリをパンクさせることはありません。

4.2 IO#each_line (File.open との組み合わせ)

ブロック付きの File.open を使用してファイルをオープンした際、ブロックに渡される file オブジェクト（これは IO クラスの子クラスのインスタンスです）は、each_line というメソッドを持っています。そのビヘイビア（Behavior）は File.foreach と非常に似ています。違いは、each_line がすでにオープンされているファイルオブジェクト上でコールされる点であり、これにより File.open ブロック内でより詳細なコントロール権を保持することができます。

puts "\n--- each_line を使用して poem.txt を行単位で処理 ---"
File.open("poem.txt", "r") do |file|
  file.each_line do |line|
    # サンプル：各行を大文字にトランスフォーム（変換）して出力
    puts "変換: #{line.chomp}" 
  end
end

File.foreach であれ IO#each_line であれ、ファイルコンテンツを行単位でイテレート（Iterate）するための優れた選択肢です。

5. 特定のデータブロック（Chunk）の読み込み

時には、ファイルから読み込むデータ量をより細かい粒度（Granularity）でコントロールする必要があります。行全体の読み込みだけでなく、固定された文字数（バイト数）を読み込んだり、一度に1文字だけをリードしたりしたい場合があります。

5.1 IO#gets (次の行を読み込む)

オープンされたファイルオブジェクトに対して gets メソッドをコールすると、ファイルから次の1行（行末の改行文字を含む）をリードします。ファイルの終端（EOF: End Of File）に到達した場合は nil をリターンします。

puts "\n--- gets を使用して手動で行単位で読み込む ---"
File.open("poem.txt", "r") do |file|
  first_line = file.gets 
  puts "読み込まれた1行目: #{first_line.chomp}"
  
  second_line = file.gets 
  puts "読み込まれた2行目: #{second_line.chomp}"
  
  puts "ループを使用して残りの行を読み込む:"
  while (line = file.gets) # file.gets がファイルの終端で nil をリターンすると、ループが終了します
    puts "- #{line.chomp}"
  end
end

条件に基づいて次の行を読み込むか決定する必要がある場合や、読み込みのペースを手動でコントロールしたい場合に gets は非常に有用です。

5.2 IO#read(length) (指定バイト数の読み込み)

オープンされたファイルオブジェクトに対して read(length) をコールすると、ファイルの現在の位置から length バイト（一般的なテキストファイルの場合、通常は文字数として理解できます）のリードを試みます。length を省略した場合、現在の位置からファイルの終端までのすべての残りのコンテンツを読み込みます。

puts "\n--- 特定のバイトブロック（チャンク）を読み込む ---"
File.open("poem.txt", "r") do |file|
  chunk1 = file.read(6) # 最初の 6 バイトを読み込む (注意: 日本語等のマルチバイト文字は 1文字あたり 3 バイト程度を消費する場合があります)
  puts "最初の 6 バイト: '#{chunk1}'"
  
  # 残りのコンテンツを読み込む
  rest_of_file = file.read
  puts "ファイルの残りの部分:\n#{rest_of_file}"
end

バイナリファイル、固定フォーマットのファイル、またはメモリフットプリントを厳密に制御する必要があるネットワークストリーム（Network Stream）を処理する際、このメソッドは非常に強力です。

6. 重要なファイルステータス（State）のバリデーション（Validation）

ファイルのオープンと読み込みを試みる前に、ファイルが実際に存在し、プログラムが読み取り権限（Read permission）を持っていることをチェックするのは、非常に優れたプログラミングプラクティスです。これは、より堅牢（Robust）で、エラーを優雅に（Gracefully）ハンドリングできるアプリケーションの構築に役立ちます。

6.1 File.exist?(path)

このクラスメソッドは、指定されたパスのファイルまたはディレクトリが存在するかどうかをチェックします。存在する場合は true、そうでない場合は false をリターンします。

puts "poem.txt は存在しますか？ #{File.exist?("poem.txt")}" 
puts "存在しないファイルは存在しますか？ #{File.exist?("non_existent.txt")}"

6.2 File.readable?(path)

このクラスメソッドは、現在のユーザー（またはプログラムを実行しているプロセス）が、そのファイルに対する読み取り権限を持っているかどうかをチェックします。

puts "poem.txt は読み取り可能ですか？ #{File.readable?("poem.txt")}"
# 特定のシステムディレクトリ下にあるファイルは読み取り不可な場合があります
# puts File.readable?("/etc/shadow") # 通常は false をリターンします

これらのチェックを組み合わせることで、ファイルの読み込みオペレーションを極めてセキュアにすることができます：

filename = "config.ini"

if File.exist?(filename)
  if File.readable?(filename)
    puts "\n'#{filename}' は存在し、読み取り可能です。コンテンツを読み込んでいます..."
    # ここに読み込みオペレーションを実装する
  else
    puts "\nエラー：'#{filename}' は存在しますが、現在のユーザーには読み取り権限がありません。"
  end
else
  puts "\nエラー：ファイル '#{filename}' が見つかりません。"
end