PRプログラミング2026年9月11日

プログラミングでエラーが出たら｜原因を切り分ける調べ方と質問の書き方

エラーが出たときに、画面の赤い文字だけを見て全部書き直したくなることがあります。ですが、まず起きていることを整理すると、直す場所を絞りやすくなります。動いていた状態と何が違うかを確認することから始めましょう。

この記事では、JavaScriptを含む小さなプログラムを例に、原因を切り分ける流れを紹介します。調べた内容を残すと、誰かへ質問する場合にも状況を伝えやすくなります。

期待した結果と実際の結果を並べる

「動かない」という一言を、具体的な現象へ置き換えます。ボタンを押しても表示が変わらない、計算結果が文字としてつながる、ページ自体が開けないなど、どの段階で違いがあるかを書いてください。入力した値と操作した順番も一緒に残します。

一度だけ起きた場合は、同じ手順で再び起きるかを確認します。再現できないときも、試した条件を残してください。問題が起きる条件と起きない条件の両方が分かると、入力や実行環境を比べる材料になります。

エラーメッセージには、問題の種類やファイル、行の情報が含まれることがあります。示された行だけでなく、その前後の括弧や変数も確認しましょう。JavaScriptでは、構文の誤りと、実行できるが結果が間違う論理の問題を分けて考えると調べる順番を整理できます。

検索するときは、変わりやすい自分のファイル名だけではなく、エラーの種類と使っている機能を組み合わせます。見つけた解決策は、言語や道具のバージョンが自分の環境に合うか確認してください。意味が分からないまま設定を次々に変えると、元の原因を追いにくくなります。

例えば足し算の結果が期待と違う場合は、計算式より先に入力の値と種類を確認します。次の例はエラーで止まりませんが、数字の合計にはなりません。どこで文字列になったのかを確認する題材にできます。

const amount = "2400";
const shipping = 500;
console.log(typeof amount); // "string"
console.log(amount + shipping); // "2400500"

この例のように、処理の途中で確認する値を決めると、予想と違い始める場所を探せます。ログを追加するときは、パスワードや個人情報を表示しないようにします。調査が終わったら、不要な出力を残していないかも見直しましょう。

一回の確認では変更を一つに絞ります。値の変換と画面の更新を同時に修正すると、どちらが原因だったか分かりにくくなります。変更前後の結果を残し、効果のない修正をさらに重ねないようにしてください。

大きなコード全体を渡すより、問題が起きる短い例を用意すると相談しやすくなります。関係ない画面やデータを外し、同じ問題が残るかを確かめましょう。外したら問題が消えた場合は、その部分が条件に関係している可能性を考えて戻しながら確認します。

コードを共有する前に、秘密情報や業務データを練習用の値へ置き換えます。画像だけでなく、必要なエラーテキストをコピーできる形で示すと読み手が確認しやすくなります。質問への回答を試したら、結果と原因を自分のメモに残しておきましょう。

入力から出力までの間で、どの値が期待と違うかを確認します。小さな処理に分けて結果を見たり、開発者ツールで途中の値を調べたりすると手掛かりになります。まず期待した結果を具体的に書くことが大切です。

補助として使う場合も、共有してよい内容かを確認し、修正の理由と結果を自分で検証しましょう。動いたように見えても、境界の値や別の入力で問題が残ることがあります。回答をそのまま採用する前に、変更した場所を読んでください。

エラーを調べるときは、期待する結果、再現手順、途中の値を順番に整理しましょう。変更を一つに絞り、結果を比較すると原因を追いやすくなります。質問する場合は最小の例と試した内容を用意し、直った理由まで記録してください。