TechAcademy（テックアカデミー） プログラミング Python Pythonでコメントアウトを書く方法【初心者向け】
オーダーメイドコース
icon
icon
Python

Pythonでコメントアウトを書く方法【初心者向け】

初心者向けにPythonのコメントの書き方について解説しています。コメントアウトを使うとコード内に説明を記述し、可読性を高めることができます。Pythonでコメントを入れる場合の書き方を覚えておきましょう。

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

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

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

 

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

 

田島悠介

今回は、Pythonに関する内容だね！

大石ゆかり

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

田島悠介

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

大石ゆかり

お願いします！

 

コメントアウトとは

ソースコード上に記述されているが、実行されない箇所をコメントと言います。言い換えると、ソースコードの見た目だけに影響し、機能に影響しないものです。

ソースコードに解説を加え、可読性や保守性を向上させるためにコメントを記述します。複数人で1つのプロジェクトを行う場合、それぞれのソースコードがどういう意味を持っているのか認識をすり合わせる必要があります。

より効率的に開発を行うためにもコメントを書くことに慣れておくと良いでしょう。

ある範囲のソースコードをコメントにすることを、「コメントアウトする」と言います。

 

コメントの書き方

‘#’から行末までがコメントになります。

Pythonには複数行をまとめてコメントにする機能はありません。

a = 1

# 行の先頭からコメントとする
# b = 2

# 行の途中からコメントとする
c = 3 # コメント

# 複数行コメント
# d = 4
# e = 5

 

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

実際に書いてみよう

サンプルコード

print('foo')
# print('bar')

実行結果

foo

解説

1行目が実行され、fooと表示されました。

2行目はコメントアウトされているので、実行されませんでした。

 

監修してくれたメンター

橋本紘希

システムインテグレータ企業勤務のシステムエンジニア。
開発実績: Javaプログラムを用いた業務用Webアプリケーションや、基幹システム用バッチアプリケーションなどの設計構築試験。

 

大石ゆかり

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

田島悠介

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

大石ゆかり

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

 

TechAcademyでは、初心者でもPythonを使った人工知能（AI）や機械学習の基礎を習得できるオンラインブートキャンプPython講座を開催しています。

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

記事を検索

関連するキーワード

関連する記事

Python3によるrange()メソッドの利用方法を現役エンジニアが解説【初心者向け】

Python3によるrange()メソッドの利用方法について解説します。 そもそもPythonについてよく分からないという方は、Pythonとは何なのか解...
Python

Pythonのurllib3パッケージについて現役エンジニアが解説【初心者向け】

Pythonのurllib3パッケージについて、TechAcademyのメンター（現役エンジニア）が実際のコードを使用して初心者向けに解説します。 &nb...
Python

Pythonで例外処理を行う方法【初心者向け】

Pythonで例外処理をする方法について解説します。 そもそもPythonについてよく分からないという方は、Pythonとは何なのか解説した記事を読むとさ...
Python

PythonでGUIアプリを作成するのにおすすめのライブラリとは？現役エンジニアが解説【初心者向け】

PythonでGUIアプリを作成するのにおすすめのライブラリについて解説します。 Pythonで作成するGUIアプリというのは、みなさんが通常Window...
Python

Pythonのpath操作を行うosモジュールの利用方法を現役エンジニアが解説【初心者向け】

Pythonのpath操作を行うosモジュールの利用方法について、テックアカデミーのメンター（現役エンジニア）が実際のコードを使用して初心者向けに解説します。...
Python

実際に書いてみよう！Pythonで演算子を使う方法【初心者向け】

今回は、Pythonで演算子を使う方法を解説します。 演算子は、プログラミング全般で必須知識なので、演算子の種類全てを覚える必要はないですが、使い方を知っ...
Python

あわせてよく読まれている記事

HTMLに1行だけコメントアウトする方法を現役デザイナーが解説【初心者向け】

ファイルの作成をしていると、一度注視して、別日に改めて作業をした時に、どこから再開すれば良いか分からなくなることがありますよね。 他にも、人に作業を依頼する際、口頭ではなくメモ書きなどがあれば助かることがあります。   そのようなときに使用するのがコメントアウトです。 コメントアウトとは、プログラムなどのソースコード上で実行に影響を与えない部分のことです。 HTMLに1行だけコメントアウトする方法について解説します。   目次 コメントアウトとは コメントアウトのメリット コメントアウトのデメリット 1行だけコメントアウトするには 複数行まとめてコメントアウトするには コメントアウトの注意点   田島悠介 今回は、HTMLに関する内容だね！ 大石ゆかり どういう内容でしょうか？ 田島悠介 1行だけコメントアウトする方法について詳しく説明していくね！ 大石ゆかり お願いします！   コメントアウトとは コメントアウトとは、プログラムのソースコード実行後でブラウザの表示画面に「読み込まれない部分」を指します。 ソースコード上にメモとして記載しておきたい内容がプログラム実行後のブラウザ画面に表示されるのは困ります。   備忘録のメモを記述してから、画面の表示として影響のない記述がコメントアウトです。 どのプログラム言語でも、コメントアウトの文法に則り、コメントアウトが可能になっています。 HTMLのコメントアウトも同様です。   [PR] 未経験からWebエンジニアを目指す方法とはコメントアウトのメリット コメントアウトのメリットを5つ紹介します。 チーム開発をスムーズに行える 保守性を高められる 定期的な更新を行える 覚書に利用できる 特定のブロックを非表示にできる それぞれ解説していきます。   チーム開発をスムーズに行える 複数人で開発を行う場合、どのコードがどのような意図で実装されたかを記載しておくとよいです。 メソッド名や変数名などは、その名前を見ただけで何をしているかわかる名前の付け方で実装しましょう。   保守性を高められる プログラムは一度開発した後も定期的に保守をする必要があります。 保守とは、プログラムの動作に不具合がないか確認する作業です。   定期的な更新を行える プログラムが完成した後も追加機能を実装することがあります。 そのときにコメントを参考に追加実装すると便利です。 その理由は、アプリリリース後などで追加機能を実装する際、コメントアウトを使用していると、追加実装箇所の特定あるいはコード共有が行いやすく、開発の効率を高められるからです。   覚書に利用できる プログラムが膨大な量になってくると、そもそもプログラムが何のために実装されているのかが不明確になりがちです。 覚書として、機能におけるプログラムの説明をコメントに記載しておくと便利です。   特定のブロックを非表示にできる プログラムのコードで、不要なコードを削除することがあります。 しかし、果たして削除してよいのかと迷うこともあります。 そのようなときは特定のコードブロックをコメントにして非表示にすることができます。 特定のコードブロックをコメントアウトし非表示にすることで、再利用する際は瞬時にコメントアウトを外せるためです。   コメントアウトのデメリット コメントアウトを利用する注意点として、デメリットが存在します。 コメントアウトを利用する際のデメリットを理解し、使い分けましょう。   不要なコメントでコードが読みづらくなる。 コメントのメリットで例示した内容をすべて利用するとコードの大部分がコメントになってしまいます。 結果的にコードが読みづらくなります。 不要なコメントが多い場合は、IDEで用意されているコードを折りたたむ機能を利用すると良いです。 VSCodeの例を確認してみましょう。   コメントを表示している状態 画像では見えませんが17行目にマウスカーソルをあわせると🔽が表示されるのでクリックしてみてください コメントを折りたたんだ状態 スッキリして見えます。 >をクリックすると再度コメント部分が表示されます。     1行だけコメントアウトするには [html] <!-- コメントアウトを記述します。（1行のコメントアウトの例） -->   <!––で始まって、備忘録の内容を記述してから、––>で閉じます。   複数行まとめてコメントアウトするには <!-- コメントアウトの1行目を記述します。 コメントアウトの2行目を記述します。 コメントアウトの3行目を記述します。 --> <!––[改行]から始めまして、複数行の備忘録の内容を記述してから、[改行]––>にて閉じます。   コメントアウトの注意点 コメントアウトを使用する際の注意点を3点紹介します。 コメントの中にコメントを入れない コメントに「-」を利用しない WordPressでの注意点と対策 それぞれ詳しく見ていきましょう。   コメントの中にコメントを入れない コメントの中にコメントを実装してしまうと、コメントの表示が崩れてしまい、結果的にコメントが表示されてしまいます。 See the Pen comment1 by マインクラフトゲームアプリプログラミング学校 (@programjp) on CodePen.   コメントに「-」を利用しない コメントに「-」を利用するのも、意図した内容が正しく認識されない可能性があります。 コメントの中に「-」を利用すると実行環境によっては、ハイフンの連続をコメントが終了した意味ととらえてしまい、結果的にコメントが表示されてしまうため、コメントの中に「-」を利用しないよう心がけましょう。 利用したい場合は「=」などの別の記号を利用しましょう。   WordPressでの注意点と対策 WordPressで「-」を利用すると、テーマによっては「-」表示が崩れることがあります。 また、WordPressの標準機能が「-」を「–」へ自動変換する環境もあります。 対策としては、WordPressのfunction.phpに次のようなコードを用意します。 function techacademy_shortcode( $atts, $content = null ) { return null; } add_shortcode('techacademy', 'techacademy_shortcode'); この状態で、WordPressの記事内でコメントアウトするときに、次のようにtechacademyで囲むことでショートコードのtechacademy_shortcodeが有効になり、非表示にすることができます。 [techacademy]非表示にしたい文字列[/techacademy] この記事を監修してくれた方 中本賢吾（なかもとけんご） アジマッチ有限会社　代表取締役社長開発実績：PHPフレームワークによるフランチャイズ企業向け会員制SNS。Shopifyによる海外進出用大規模ネットショップ構築。Vue.jsによる金融機関向け内部アプリ。AWSやLinuxハウジングサーバーでの環境構築。人工知能を利用した画像判別システム。小売チェーン店舗用スマホアプリ。Wordpressによる不動産チェーン店向け賃貸・売買仲介システム。基幹システム移管用データコンバートシステム。ボランティア活動：小学生がオリジナルAndroidアプリをGooglePlayでリリース、NHK Whyプログラミング入賞、全国Programing Festival入賞、中学生がSNS型PWAアプリリリースする市クラブ講座活動を行っている。     大石ゆかり 内容分かりやすくて良かったです！ 田島悠介 ゆかりちゃんも分からないことがあったら質問してね！ 大石ゆかり 分かりました。ありがとうございます！   HTMLを学習中の方へ これで解説は終了です、お疲れさまでした。 つまずかず「効率的に」学びたい 副業や転職後の「現場で使える」知識やスキルを身につけたい HTMLを学習していて、このように思ったことはありませんか？ テックアカデミーのWebデザインコースでは、第一線で活躍する「プロのWebデザイナー」が教えているので、効率的に実践的なスキルを完全オンラインでしっかり習得できます。 合格率10%の選考を通過した、選ばれたWebデザイナーの手厚いサポートを受けながら、オリジナルのWebサイト制作を完全オンラインでしっかり習得できます。 まずは一度、無料体験で学習の悩みや今後のキャリアについて話してみて、「現役Webデザイナーから教わること」を実感してみてください。 時間がない方、深く知ってから体験してみたい方は、今スグ見られる説明動画から先に視聴することをおすすめします！
HTML

CSSでコメントアウトを書く方法【初心者向け】

CSSでコメントアウトする方法について解説しています。 Cloud9のエディターなどでは、Macであれば「command」+「/」、Windowsであれば「Ctrl」+「/」でコメントアウトできるので、ショートカットも覚えておくと便利でしょう。 目次 コメントアウトとは コメントアウトの書き方 実際に書いてみよう コメントアウトのショートカットキー コメントの書き方について   大石ゆかり 田島メンター！！ CSSファイルで編集したいところがあるのですが、どれがどの部分だったか見つけるのが大変になってしまって……何かいい方法はありませんか〜？ 田島悠介 コメント機能は使っているかな？ 何について指定しているかを書いておくだけでもだいぶ違うと思うよ。 大石ゆかり コメントというのは何ですか〜？ 田島悠介 ソース内の一部分を実行されない状態にする機能だよ。 これによって文字列などをメモとして残しておくことができるんだ。   コメントアウトとは コメントアウトとは、ソースコード上に書いたメモや説明をソースコードとして認識させず、無効化することを指します。 プログラムを書いているとソースコードが長くなってしまい、それぞれのコードの動作がわかりづらくなります。 他の人が書いたプログラムであれば、余計に直感的に動作がイメージできないことが多いです。 それを防ぐために、ソースコード上にコメントを残しておくことで、そのソースコードの動作を記載しておくことができます。 コメントアウトで残したコメントは、プログラム上では無視されるため、いくら書いてもプログラムの動作には影響しません。   [PR] 未経験からWebエンジニアを目指す方法とはコメントアウトの書き方 CSSファイル、またはHTMLファイルの<style>〜</style>タグの間のコメントアウトは、 /**/ の間にコメントを書きます。 /* この中に書かれたものがコメントになります。 */   /**/の間を改行して書くこともできます。 /* 改行しても コメントに なります。 */   田島悠介 /*と*/の間に書かれた内容がコメントとして処理されるんだ。 大石ゆかり コメントは複数行書いてもいいんですね。 田島悠介 そうだね。 実際にコメントを入れてみて、画面に影響があるかどうか見てみよう。   実際に書いてみよう それでは実際に書いて確認してみましょう。 「comment_out.html」というファイルを作成して、以下の内容を記述します。 comment_out.html <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <title></title> <link rel="stylesheet" href=""> <style> /* h1は少し赤っぽく */ h1 {
CSS

覚えておくと便利！PHPでコメントアウトする書き方【初心者向け】現役エンジニアが解説

PHPでコメントアウトをする書き方について、テックアカデミーのメンター（現役エンジニア）が実際のコードを使用して初心者向けに解説します。 複数人で作業をする際は他の人が見ても分かるようにコメントを書いておくことが多いでしょう。 また、作業中にあとで必要になるかもしれないソースコードはコメントアウトするはずです。 今回は、PHPでその書き方を紹介しているので、ぜひ覚えておきましょう。   目次コメントアウトとはコメントの書き方実際に書いてみよう監修してくれたメンター   そもそもPHPについてよく分からないという方は、PHPとは何なのか解説した記事を読むとさらに理解が深まります。   大石ゆかり 田島メンター！コメントアウトってどうやって書いたらいいんですか〜？ 田島悠介 とても簡単だけど1行の時と複数行の時で書き方がちょっと違うから書きながら見ていこうか！ 大石ゆかり お願いします！   コメントアウトとは コメントアウトとは、どのようなプログラムかをわかりやすくするために書いておくことをいいます。 ソースコード上に書いてもコンパイル時や実行時には無視されます。 そのため、あくまでも人が読んで「この部分はこういうふうに動作するのか」といった情報を共有するために記述します。   コメントアウトする書き方 PHPでのコメントアウトの書き方は2つあります。 1つは「1行でコメントを記述する場合」で、もう1つは「複数行でコメントを記述する場合」です。   1行でコメントを書く場合は以下のコードです。 // 1行コメントはこのように書きます。 // を先頭に記述して、その後にコメントを書くことでコメントアウトできます。   複数行でコメントを書く場合は以下のコードです。 /* 複数行でコメントを 書く場合は、このように 書きます。 */ /* と */ の間にコメント文を書くことでコメントアウトできます。   [PR] 未経験からWebエンジニアを目指す方法とは実際に書いてみよう それでは実際にプログラムを書いてみましょう。 関数を2つ定義して、それがどのように動作するかを記述します。 <?php // 数値を2ついれて、その和を出力する関数 function add($x, $y){ /* 変数$addに $xと$yを足した 合計を代入する */ $add=$x+$y; // 変数$addを返す return $add; } // 数値を2ついれて、その差を出力する関数 function sub($x, $y){ /* 変数$sub
PHP

Pythonにおける複数行コメントの記述方法を現役エンジニアが解説【初心者向け】

Pythonにおける複数行コメントの記述方法について、テックアカデミーのメンター（現役エンジニア）が実際のコードを使用して初心者向けに解説します。 目次コメントアウトとはコメントの書き方実際に書いてみよう監修してくれたメンター そもそもPythonについてよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まります。   田島悠介 今回は、Pythonに関する内容だね！ 大石ゆかり どういう内容でしょうか？ 田島悠介 Pythonにおける複数行コメントの記述方法について詳しく説明していくね！ 大石ゆかり お願いします！   コメント機能とは？ プログラムを書く際、どの言語においても処理内容や関数の説明を載せるときにソースコードにメモ（コメント）を残します。 この機能をコメント機能またはコメントアウトといいます。 コメント機能を使うことでプログラムに影響することなくソースコード内にメモを残せます。 また、コメントアウトによってソースコードの一部を実行されないようにできます。   コメント機能は次のような目的で使われます。 自身でソースコードを見直す時に備えて、何を考えてそのコードを書いたのか記しておくため。 自分の意図を伝えることで、ソースコードを他の人にも理解しやすくするため。 エラーの原因を探す際や、コードの書き方を試行錯誤する際に、特定の行を実行しないようにするため。   コメント機能の使い方 1行のコメント 1行でコメントアウトを行う際には#使って記述します。 例 # ここはコメント # print("ここもコメント、実行しない") print("ここは実行する")   複数行のコメント 今回の本題の複数行でのコメントです。 複数行でコメントを残すときには、シングルクォーテーションまたはダブルクォーテーションを3つつなげたもので両端を囲んでコメントアウトします。 この手法はGitHubで公開しているコードやドキュメント作成を行う際にはよく使用されます。 例 """ ここはコメントです。 実行はされません。 """ print("Hello World")   [PR] 未経験からWebエンジニアを目指す方法とはコメント機能を使って複数行のコメントをしてみよう それでは、複数行のコメントをしてみましょう。 まずは以下のソースコードをコピーして任意の場所に保存しましょう。 def test(a): """引数 a:数字（int） """ return a + 1 print(test(2)) 上記コードを実行すると、test関数に2を引数として渡した結果が返ってくると思います。 関数内のコメントで引数の説明を入れているのが分かります。 このようにして、関数の説明を行い引数を説明することで、引き継ぎで誰かにコードを渡す際に関数内の処理を知れてチーム開発の効率があがります。 複数行のコメントを行う際は、インデントに注意する必要があります。 関数の定義, if文などインデントを行うブロック内で複数行のコメントを行う場合は、上記コードのようにコメント部分もインデントを揃える必要があります。   まとめ 今回はPythonにおいてのコメント機能を紹介しました。 他人に自分のソースコードを読んでもらうためにコメントはとても大切です。 ただし、あまり使いすぎるとかえって読みづらくなるので、適度に使うようにしましょう。   大石ゆかり 内容が分かりやすくて良かったです！ 田島悠介 ゆかりちゃんも分からないことがあったら質問してね！ 大石ゆかり 分かりました。ありがとうございます！   Pythonを学習中の方へ これで解説は終了です、お疲れさまでした。 つまずかず「効率的に」学びたい 副業や転職後の「現場で使える」知識やスキルを身につけたい プログラミングを学習していて、このように思ったことはありませんか？ テックアカデミーのPythonコースでは、第一線で活躍する「プロのエンジニア」が教えているので、効率的に実践的なスキルを完全オンラインでしっかり習得できます。 合格率10%の選考を通過した、選ばれたエンジニアの手厚いサポートを受けながら、人工知能（AI）や機械学習の基礎を学べます。 まずは一度、無料体験で学習の悩みや今後のキャリアについて話してみて、「現役エンジニアから教わること」を実感してみてください。 時間がない方、深く知ってから体験してみたい方は、今スグ見られる説明動画から先に視聴することをおすすめします！
Python

Pythonのダブルクォーテーション3つで囲まれたコメントについて現役エンジニアが解説【初心者向け】

Pythonのダブルクォーテーション3つで囲まれたコメントについて、TechAcademyのメンター（現役エンジニア）が実際のコードを使用して、初心者向けに解説します。 Pythonについてそもそもよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まります。   なお本記事は、TechAcademyのオンラインブートキャンプ、Python講座の内容をもとに紹介しています。   田島悠介 今回は、Pythonに関する内容だね！ 大石ゆかり どういう内容でしょうか？ 田島悠介 Pythonのダブルクォーテーション3つで囲まれたコメントについて詳しく説明していくね！ 大石ゆかり お願いします！ Pythonだけに限りませんが、プログラミングにおいてコメントは重要な役割を果たします。 他人や自分のためのメモとして使うのはもちろんのこと、コメントアウトしてデバッグする際にも役立ちます。また、フォルダのdeleteなどの一度行うと取り返しがつかないようなコードをコメントアウトし、deleteされるフォルダを確認してからコメントを外すといった使い方もあります。 ただ、多くの記事や参考書ではコメントについてあまり詳しく書かれていないのが現状です。そこでこの記事では、Pythonにおけるコメントについての仕方について徹底的に解説します。 ダブルクォーテーション3つで囲まれたコメントについて 普通のコメントを#で行うのは多くの方がご存知かと思いますので、複数業のコメントのやり方から解説していきます。複数行のコメントを書こうと思った際に以下のように書くのは面倒ですよね。 #コメント1行目 #コメント2行目 #コメント3行目 そのため、複数行コメントは以下のようにダブルクォーテーションで囲んであげるのが普通です。 """ コメント1行目 コメント2行目 コメント3行目 """ こうすることで、例え膨大な行のコメントを書かなければならなくなったとしても、瞬時にコメントを作成できます。また、複数行コメントはダブルクォーテーションでなくシングルクォーテーションを用いて以下のように書くこともできます。 ''' コメント1行目 コメント2行目 コメント3行目 '''   シングルクォートとダブルクォートの違い ではシングルクォートとダブルクォートのどちらを使えばいいのでしょうか？結論から言うと、どちらでも大丈夫です。完全に好みの問題です。 ただし、以下のようにコメント文自体にクォーテーションを使いたいときには、以下のようにシングルクォートとダブルクォートを分けた方が見やすいでしょう。 ''' 一番上を"header"という。 真ん中を"body"という。 一番下を"footer"という。 '''   [PR] 未経験からWebエンジニアを目指す方法とはその他のコメントの書き方との比較 その他のコメントの書き方として、関数アノテーションというものがあります。 これはPython3系から追加された機能です。このようにして関数に関する説明をする方法もあります。アノテーションの箇所には変数のデータ型を書くことが多いです。ただし、初心者の方は知らなくても大丈夫かと def function_2st(s: "sのアノテーション", t: "tのアノテーション") -> '戻り値のアノテーション': return 2 * s * t   まとめ この記事ではPythonのコメントの書き方について徹底的に解説しました。これで今後コメントについて悩むことはなくなるでしょう。 監修してくれたメンター 柴山真沙希（しばやままさき） 大手IT企業などでエンジニアとして2年ほど勤務した後、個人事業主としてプログラミングスクール「エンペサール」を経営。子供から大人まで幅広い層を対象にプログラミングを教えている。 得意言語はPython, HTML, CSSで、機械学習やデータ分析、スクレイピングなどが得意。サッカー観戦や読書が趣味である。   大石ゆかり 内容分かりやすくて良かったです！ 田島悠介 ゆかりちゃんも分からないことがあったら質問してね！ 大石ゆかり 分かりました。ありがとうございます！   TechAcademyでは、初心者でも、Pythonを使った人工知能（AI）や機械学習の基礎を習得できる、オンラインブートキャンプを開催しています。 また、現役エンジニアから学べる無料体験も実施しているので、ぜひ参加してみてください。
Python

HTMLでコメントを書く方法【初心者向け】

HTMLについて今さら聞けない！という初心者のために、HTMLの基礎を紹介する記事です。 今回は、HTMLでコメントを書く（コメントアウトする）方法について解説します。 そもそもHTMLの記述方法がわからない場合は、HTMLの書き方について解説した記事を読むとさらに理解が深まります。   なお本記事は、TechAcademyのオンラインブートキャンプWebデザイン講座のHTMLカリキュラムをもとに執筆しています。   なお、今回の記事の内容は動画でもご覧いただけます。 テキストよりも動画の方が理解しやすいという場合はぜひご覧ください。   田島悠介 今回は、HTMLに関する内容だね！ 大石ゆかり どういう内容でしょうか？ 田島悠介 コメントを書く方法について詳しく説明していくね！ 大石ゆかり お願いします！   HTMLのコメントアウト コメント（コメントアウト）とは、プログラミングなどでコードを読み返すときに内容をわかりやすくするための覚え書きです。コメントで囲まれた部分はプログラムではないとみなされ、コンピューター上で実行・反映されない部分となります。   たとえば、長いコードを書くときや複数人でコードを書くときに、コメントアウトで注意事項が添えられていれば、コードを探す手間が省けます。またプログラムの一部をコメントアウトすることによって、その動作をスキップさせることができるので、開発中にコードの確認を行いたいときにもよく使われます。 のちに自分でページをメンテナンスするときにも非常に有効になりますのでぜひ覚えておきましょう。   大石ゆかり HTMLにコメントなんて必要なんですか？タグにわざわざコメントをつけたりしないですよね？ 田島悠介 基本的にタグそのものにコメントを書くことはあまりないですね。 大石ゆかり どんな時に使うんですか？ 田島悠介 レイアウトのための段組みなど、複雑になりがちなところとかに使うんだよ。 大石ゆかり なるほどー！   では実際に書いてみましょう。 HTMLにおけるコメントの書き方は下の通りです。 <!– ここにコメント –> （※コメント前後の半角スペースはなくてもかまいません。） この例では、<!– ここにコメントを入れます –>といったコメント書いています。 この内容はWebブラウザで出力しても表示されないことがわかりますね。 書き方はこれだけなので、すぐに覚えてしまいましょう。   HTMLでコメントを書く場合の注意点 HTMLでコメントを書く場合、次のことに注意していただくと良いです。 次のどの場合も、HTML文法エラーになってしまいます。 1.コメントの中で-という記号を使用しない コメントの中で-という記号を使用する習慣がついてしまうと、コメント中にもかかわらず、–>と記載するミスに繋がりかねません。 また、環境によっては、-が連続で記載されることを、コメント行の終了と認識してしまうこともあります。 2.コメントタグを記載した後、全角入力にする コメントの内部では、全角日本語の入力を行うことが多いと思います。 そのため、コメントタグ自体も＜！－－という全角日本語入力した後、変換機能を利用して<!–という記載にされる方もいらっしゃいます。 しかし、<!–に変換し忘れた場合は、＜！－－という全角日本語のまま、HTML上に記載されることになります。   今回はHTMLでコメントを書く方法についてご紹介しました。 HTMLについてさらに学びたい場合は、HTMLでiframeを使う方法も合わせてご覧ください。   大石ゆかり コメントの書き方はHTMLと仲間のCSSでも同じですか？ 田島悠介 そういえば、HTMLだけコメントの書き方が違うね。 大石ゆかり 他ではどうなっていますか？ 田島悠介 CSSは、/* */を使うね。他のプログラミング言語でも使えます。プログラミング言語の場合は、もうひとつ1行コメント専用の//もあります。 この記事を監修してくれた方 中本賢吾（なかもとけんご） アジマッチ有限会社　代表取締役社長 開発実績：PHPフレームワークを利用した会員制SNS・ネットショップ構築、AWSや専用サーバー下でLinuxを使用したセキュアな環境構築、人工知能を利用したシステム開発、店舗検索スマホアプリ開発など。 その他にも地域の職業プログラマー育成活動を行い、2018年には小学生がUnityで開発したオリジナルAndroidアプリをGooglePlayでリリース。ゲームで遊ぶより作ろうぜ！を合言葉に、小学生でも起業できる技術力を育成可能で有ることを証明し続けている。 TechAcademyでは、初心者でもオリジナルWebサイトを公開できるオンラインブートキャンプWebデザイン講座を開催しています。 挫折しない学習方法を知れる説明動画や、現役エンジニアとのビデオ通話とチャットサポート、学習用カリキュラムを体験できる無料体験も実施しているので、ぜひ参加してみてください。
HTML

あなたの目的に合わせて学べるコース

副業したい方

Web制作の力を身につけ
副業までサポート

はじめての副業コース

転職したい方

未経験から
Webエンジニアに

Webエンジニア転職保証コース

スキルアップしたい方

AIも統計解析もできる
Pythonを学ぶ

Pythonコース

※ 経済産業省の行うリスキリングを通じたキャリアアップ支援事業の補助金対象コースです。条件を満たすことで支払った受講料の最大70％がキャッシュバックされます。詳しくは こちら のページをご確認ください。

TechAcademyから
現役エンジニアの方へ
お知らせ

オーダーメイドコース
TechAcademy（テックアカデミー） プログラミング Python Pythonでコメントアウトを書く方法【初心者向け】