ハードコーディングとは？
プログラミングを学び始めたころ、コードの中に直接「1000」や「東京」といった具体的な値を書いていたら、先輩に「それ、ハードコーディングだから気をつけて」と言われて戸惑った経験はありませんか。
ハードコーディングは、初心者がつい無意識にやってしまいがちな書き方であり、知らないままでいると後々のトラブルにつながることもあります。
この記事では、プログラミング初心者の方に向けて、ハードコーディングとは何か、なぜ避けたほうがよいのか、そしてどうすれば避けられるのかを、具体例を交えながらやさしく解説します。
ハードコーディング（hard coding）とは、設定値やデータを、プログラムのソースコードの中に直接書き込んでしまう手法のことです。
ハードコードともいう
「hard（ハード）」には「硬い・固定された」という意味があり、値がコードの中に固定的に埋め込まれている状態を表しています。
たとえば、消費税率や管理者のメールアドレス、APIの接続先といった、本来は状況に応じて変わりうる値を、プログラムの処理の中にそのまま書いてしまうのがハードコーディングです。
一見すると手っ取り早く動くため、初心者は無意識にやってしまいがちですが、後から値を変更したいときに苦労する原因になります。
ハードコーディングの具体例
言葉だけではイメージしづらいので、簡単なコードで見てみましょう。
たとえば、商品価格に消費税を加えて合計金額を計算する処理を考えます。
次のように税率の「0.1」を計算式の中に直接書いてしまうのが、ハードコーディングの典型例です。
// 税率を直接書いている（ハードコーディング）
function calcTotal(price) {
return price + price * 0.1;
}このコードは問題なく動きますが、もし将来、消費税率が変わったらどうなるでしょうか。
「0.1」と書かれた箇所を、コードの中から探し出して書き換える必要があります。
同じ税率を別の場所でも使っていた場合は、そのすべてを探して直さなければならず、ひとつでも直し忘れると不具合の原因になります。
このように、本来は変わりうる値をコードに直接埋め込んでしまうと、変更のたびに手間とリスクが発生します。
なぜハードコーディングは避けるべきなのか
ハードコーディングが避けられがちなのは、主に次のようなデメリットがあるためです。
変更に手間がかかる
値がコードのあちこちに直接書かれていると、変更が必要になったときに、該当箇所をすべて探して修正しなければなりません。
修正箇所が多いほど手間がかかり、直し忘れによる不具合も起きやすくなります。
コードの意味がわかりにくくなる
コードの中に「0.1」や「100」といった数値がそのまま書かれていると、後から見た人には、その数字が何を意味するのか伝わりません。
「これは税率なのか、それとも別の係数なのか」と迷う原因になり、可読性（読みやすさ）を下げてしまいます。
チーム開発や環境の切り替えで困る
接続先のサーバーやファイルの場所などをハードコーディングしていると、開発用と本番用で環境を切り替えるたびに、コードそのものを書き換える必要が出てきます。
これはチームでの開発や、複数の環境を扱う場面で大きな手間となり、ミスの温床にもなります。
セキュリティ上のリスクになりうる
パスワードやAPIキーといった秘密情報をコードに直接書き込むと、そのコードを見られた際に情報が漏れてしまう危険があります。
特に、ソースコードを共有・公開する場面では、こうした秘密情報のハードコーディングは重大なリスクになるため、特に注意が必要です。
ハードコーディングを避ける方法
では、ハードコーディングはどう避ければよいのでしょうか。
基本的な考え方は、「コードと、変わりうる値（設定）を分離する」ことです。
代表的な方法を3つ紹介します。
1. 定数として名前をつける
もっとも手軽な第一歩は、値に意味のある名前をつけて定数として定義することです。
先ほどの税率の例なら、次のように書き換えられます。
// 税率に名前をつけて定数化する
const TAX_RATE = 0.1;
function calcTotal(price) {
return price + price * TAX_RATE;
}こうしておけば、税率を変更したいときは「TAX_RATE」の値を1か所変えるだけで済みます。
さらに「TAX_RATE（税率）」という名前から、その値が何を表すのかも一目でわかるようになります。
2. 設定ファイルに分ける
値の数が増えてきたら、設定値をコードとは別の「設定ファイル」にまとめる方法があります。
プログラム本体はその設定ファイルを読み込んで動くようにしておくことで、値を変えたいときはコードを触らずに設定ファイルだけを編集すれば済みます。
コードと設定がきれいに分かれるため、管理がしやすくなります。
3. 環境変数を使う
接続先の情報やパスワード、APIキーといった、環境ごとに変わる値や秘密情報には、環境変数を使うのが一般的です。
環境変数とは、プログラムの外側（実行環境）に値を持たせておき、プログラムからそれを読み込む仕組みのことです。
これにより、開発用と本番用で値を切り替えやすくなり、秘密情報をソースコードに直接書かずに済むため、セキュリティ面でも安全になります。
ハードコーディングが許容される場面もある
ここまで避けるべき理由を説明してきましたが、ハードコーディングが常に「悪」というわけではありません。
たとえば、今後まず変わることのない値や、学習やお試しのために書く使い捨ての小さなコードでは、わざわざ設定を分離するほうがかえって手間になることもあります。
大切なのは、「この値は将来変わる可能性があるか」「複数の場所で使うか」「秘密情報か」を考え、状況に応じて判断することです。
変わりうる値や秘密情報は分離し、本当に固定でよいものだけ直接書く、というバランス感覚を持つことが、よいコードを書く第一歩になります。
まとめ
ハードコーディングとは、設定値やデータをソースコードに直接書き込む手法のことです。
手軽な反面、変更の手間がかかる、コードが読みにくくなる、環境の切り替えで困る、セキュリティリスクになる、といったデメリットがあります。
これらを避けるには、値を定数として名前をつける、設定ファイルに分ける、環境変数を使うといった方法で、コードと設定を分離するのが基本です。
ただし、ハードコーディングが常に悪いわけではなく、状況に応じて判断することが大切です。
まずは「この値は直接書いて大丈夫か？」と一度立ち止まって考える習慣をつけることから始めてみてください。
