ログとデバッグの基本｜エラーを見つけて解決する方法

🔰GAS基礎編
2025.06.14

前回の記事でGASエディタの使い方を学びました。今回は、プログラミングで避けて通れない「エラー」との付き合い方について解説します。ログの活用方法からエラーメッセージの読み方まで、効果的なデバッグ手法をマスターしましょう。

デバッグって何？なぜ重要なの？

デバッグとは、プログラムの不具合（バグ）を見つけて修正する作業のことです。「バグ」という言葉は、コンピューターの黎明期に実際の虫（bug）が機械に挟まってトラブルを起こしたことが語源とされています。

プログラミングにおいて、一度でエラーなくコードが動くことは稀です。むしろ、エラーが出ることは当たり前で、それを素早く解決できるかどうかが、プログラミングスキルの重要な要素になります。

エラーを恐れる必要はありません。エラーメッセージは、プログラムからの「ここに問題がありますよ」という親切なお知らせです。適切に読み解けば、問題解決への近道となります。

console.log()を使いこなそう

基本的な使い方

前回までの記事で、console.log()を使って文字列を表示する方法を学びました。デバッグでは、この機能をより積極的に活用します。

変数の値を確認したい時は、console.log("変数名:", 変数名);という形で出力します。
例えば、var name = "太郎"; console.log("name:", name);とすると、ログに「name: 太郎」と表示されます。

複数の値を同時に出力することも可能です。console.log("名前:", name, "年齢:", age);のように書けば、複数の情報を一度に確認できます。

プログラムの流れを追跡する

複雑な処理では、どの部分が実行されているかを確認することが重要です。関数の開始と終了にログを配置することで、プログラムの実行順序を把握できます。

javascriptfunction processData() {
  console.log("データ処理を開始します");
  
  // 何らかの処理
  
  console.log("データ処理が完了しました");
}

if文やfor文の中にもログを配置することで、条件分岐や繰り返し処理の動作を詳しく観察できます。

変数の状態を監視する

変数の値が期待通りに変化しているかを確認するために、処理の要所要所でログを出力しましょう。特に、計算結果や外部から取得したデータの内容を確認する際に有効です。

javascriptfunction calculate(a, b) {
  console.log("入力値 a:", a, "b:", b);
  
  var result = a + b;
  console.log("計算結果:", result);
  
  return result;
}

よくあるエラーの種類と対処法

構文エラー（SyntaxError）

構文エラーは、コードの書き方に問題がある場合に発生します。括弧の対応が取れていない、セミコロンが抜けている、変数名にスペルミスがあるといった、文法的な間違いが原因です。

エラーメッセージには「SyntaxError: Unexpected token」や「SyntaxError: Missing ) after argument list」といった内容が表示されます。メッセージと一緒に表示される行番号を確認して、該当箇所のタイプミスや記号の間違いをチェックしましょう。

よくある構文エラーとしては、文字列のクォーテーションが閉じられていない、if文の条件式で「=」と「==」を間違える、関数名にスペルミスがあるといったものがあります。

参照エラー（ReferenceError）

参照エラーは、存在しない変数や関数を呼び出そうとした時に発生します。「ReferenceError: 変数名 is not defined」という形でエラーメッセージが表示されます。

変数名のスペルミス、変数を定義する前に使用している、スコープ（変数の有効範囲）の問題などが主な原因です。変数名を再確認し、定義順序を見直すことで解決できることが多いです。

型エラー（TypeError）

型エラーは、データ型に関する問題で発生します。「TypeError: Cannot read property of undefined」や「TypeError: 変数名 is not a function」といったメッセージが表示されます。

数値として扱いたい変数が文字列になっている、配列だと思っていた変数が実際には別の型だった、関数ではないものを関数として呼び出そうとしたといった場合に発生します。

エラーメッセージの読み方

エラーメッセージの構成

GASのエラーメッセージは、通常以下の要素で構成されています。エラーの種類（SyntaxError、ReferenceErrorなど）、具体的な問題の説明、発生した行番号、問題のあるコードの一部です。

例えば、「ReferenceError: myVariable is not defined (line 5, file “Code”)」というメッセージなら、5行目で「myVariable」という未定義の変数を参照しようとしたということが分かります。

行番号の活用

エラーメッセージに表示される行番号は、問題解決の重要な手がかりです。ただし、実際の問題は指定された行よりも前にある場合もあります。例えば、前の行でクォーテーションを閉じ忘れている場合、エラーは次の行で検出されることがあります。

エラーが発生した行とその前後の行を注意深く確認することが大切です。

段階的なデバッグ手法

最小限のコードから始める

複雑なプログラムでエラーが発生した場合、まずは最小限のコードで動作することを確認しましょう。基本的な機能から順番に追加していくことで、どの部分で問題が発生するかを特定できます。

例えば、スプレッドシートからデータを取得してメール送信するプログラムなら、まず「スプレッドシートからデータを取得する部分だけ」「メール送信する部分だけ」を個別にテストします。

コメントアウトを活用する

問題のある箇所を特定するために、コメントアウト機能を活用しましょう。疑わしい行を一時的に無効化することで、エラーの原因を絞り込めます。

行の先頭に「//」を付けるか、複数行を「/」と「/」で囲むことで、コメントアウトできます。GASエディタでは、行を選択してCtrl+/（Macの場合はCmd+/）を押すことで、簡単にコメントアウトの切り替えができます。

一つずつ機能を追加する

新しい機能を追加する際は、一度に大量のコードを書くのではなく、小さな単位で動作を確認しながら進めましょう。一つの機能が正常に動作することを確認してから、次の機能を追加するという手順を踏むことで、問題の発生箇所を限定できます。

実践的なデバッグ例

ケース1：変数の値が期待と違う

javascriptfunction calculateTotal() {
  var price = "1000";
  var tax = 0.1;
  var total = price * (1 + tax);
  
  console.log("price:", price, "型:", typeof price);
  console.log("total:", total);
}

この例では、price変数が文字列になっているため、計算結果が期待と異なる可能性があります。typeof演算子を使って変数の型を確認し、必要に応じてparseInt()やparseFloat()で数値に変換します。

ケース2：配列の要素にアクセスできない

javascriptfunction processArray() {
  var data = [1, 2, 3];
  
  console.log("配列の長さ:", data.length);
  console.log("1番目の要素:", data[0]);
  console.log("4番目の要素:", data[3]); // undefined
}

配列の範囲外にアクセスしようとした場合、undefinedが返されます。配列の長さを確認し、有効なインデックスでアクセスしているかをチェックしましょう。

トラブルシューティングのコツ

エラーの再現性を確認する

エラーが毎回発生するのか、特定の条件でのみ発生するのかを確認しましょう。再現性のあるエラーは比較的解決しやすいですが、時々しか発生しないエラーは原因の特定が困難な場合があります。

検索を活用する

エラーメッセージをそのまま検索エンジンで調べることも有効な方法です。同じ問題に遭遇した人の解決方法を参考にできる場合があります。ただし、コードの構造や使用している機能が異なる場合があるので、そのまま適用せず、原理を理解してから自分のコードに応用しましょう。

定期的な保存とバックアップ

GASは自動保存機能がありますが、大きな変更を加える前には手動で保存し、必要に応じてコードをコピーしてバックアップを取っておくことをお勧めします。試行錯誤の過程で、動いていたコードを壊してしまうことがあるためです。

まとめと次のステップ

今回の記事で、エラーとの正しい付き合い方と、効果的なデバッグ手法を学びました。エラーは敵ではなく、よりよいプログラムを作るためのパートナーです。

ログを活用した動作確認、エラーメッセージの適切な読み方、段階的なトラブルシューティングの手法を身につけることで、プログラミングの効率と品質が大幅に向上します。

これで基礎編シリーズは完了です。次回からは、実際にGoogleの各種サービスと連携した実用的なスクリプト作成に挑戦していきます。スプレッドシートの操作、メール送信、カレンダー連携など、業務で活用できる具体的な機能を一つずつマスターしていきましょう。

今回学んだデバッグスキルは、今後どんなに複雑なプログラムを作る際にも必ず役立ちます。恐れずにコードを書き、エラーが出たら冷静に原因を探り、一つずつ解決していく習慣を身につけてください。

基礎編完了おめでとうございます！ ここまでの5記事で、GASプログラミングの基本的な知識と技術を身につけました。次は実践編で、実際に役立つプログラムを作成していきましょう。

コメント