オーダーメイドコース
icon
icon

Rubyのコメントの書き方を現役エンジニアが解説【初心者向け】

初心者向けにRubyのコメントの書き方について解説しています。ソースコード内にその内容についての覚え書きを入れることで可読性を高めることができます。Rubyで一行のコメント、複数行のコメントを入れる場合それぞれの方法について学びましょう。

テックアカデミーマガジンは受講者数No.1のプログラミングスクール「テックアカデミー」が運営。初心者向けにプロが解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。 ※ アンケートモニター提供元:GMOリサーチ株式会社 調査期間:2021年8月12日~8月16日  調査対象:2020年8月以降にプログラミングスクールを受講した18~80歳の男女1,000名  調査手法:インターネット調査

Rubyのコメントの書き方について解説します。

 
そもそもRubyについてよく分からないという方は、Rubyとは何なのか解説した記事を読むとさらに理解が深まります。

なお本記事は、TechAcademyのオンラインブートキャンプRuby講座の内容をもとに紹介しています。

 

田島悠介

今回は、Rubyに関する内容だね!

大石ゆかり

どういう内容でしょうか?

田島悠介

コメントの書き方について詳しく説明していくね!

大石ゆかり

お願いします!

 

コメントとは

今回はRubyのコメントについて紹介していきます。

いろいろとコードを書いていくと、そのコードの意味などを、きちんと日本語だけでなく、明示しておいた方が便利な場合が多々あります。

しかし、コードに日本語にみならず、任意の好きな言葉を書いてしまうと、それにプログラムが反応してしまい、エラーなどのバグを生じさせます。

このような場合にプログラムに反応させることなくコードにメモ書きを残すことをするために、コメントという機能がRubyには備わっています。

 

コメントの書き方

一行コメントの書き方

まずコメントの書き方ですが、こちは行の先頭に#を書くだけです。

これだけでその行がコメント扱いとなり、コードでは無視されることになります。

 

#コメント

def  ~

end

 

こんな感じになります。

 

複数行コメントの書き方

複数行コメントの書き方としては

 

=begin 
コメント
=end

 

と書きます。

=beginと=endに囲まれたところがコメントとなりプログラムのコード上無視されることとなります。

 

[PR] 未経験からWebエンジニアを目指す方法とは

実際に書いてみよう

それでは実際に書いてみましょう。

 

#電車と表示します。
def train
  puts "電車"
end

train

 

こちらのメソッドを実行するときに、#の行は無視されますが、どのようなメソッドであるかを明示していますので、後になって確認することができます。

 

=begin
1番なら急行列車と表示
それ以外なら各駅停車と表示
=end
def train(x)
  if x == 1
    puts "急行列車です"
  else
    puts "各駅停車です"
  end
end

train(1)

 

2行以上になるコメントの場合はこのように記述しても良いです。

 

筆者プロフィール

町田 耕

学生時代は会計学専攻。塾講師勤務を経て、企業のCFOとして会社経営に携わる。

会社経営から一線を退いた後、インフラエンジニアの妻の勧めでプログラミングを

独学で始め、プログラミングセミナーなど転々としながら、開発案件に携わるようになる。

現在、フリーランスとして活動しながらテックアカデミーのメンターも勤めている。

 

大石ゆかり

内容分かりやすくて良かったです!

田島悠介

ゆかりちゃんも分からないことがあったら質問してね!

大石ゆかり

分かりました。ありがとうございます!

 

TechAcademyでは、初心者でもRuby on Railsを使ったプログラミングを習得できるオンラインブートキャンプRuby講座を開催しています。

挫折しない学習方法を知れる説明動画や、現役エンジニアとのビデオ通話とチャットサポート、学習用カリキュラムを体験できる無料体験も実施しているので、ぜひ参加してみてください。