本サイトはアフィリエイト広告（A8.net／もしもアフィリエイト／アクセストレード等）を利用しています
GASログ出力console.logでデバッグ完全版｜Logger.logとの違い・応用テク10選
📂 GAS入門

GASログ出力console.logでデバッグ完全版｜Logger.logとの違い・応用テク10選

📅 ⏱ 読了 約9分 ✍️ 凛

💡 本記事には広告（アフィリエイトリンク）が含まれる場合があります。

こんにちは、凛です。2児のママで現役ナース。夜勤明けの細切れ時間を副業GASに投じ、月5〜8万円の副収入を継続中。「看護師でもコードは書ける」を合言葉に、家事育児とプログラミングを両立する等身大の情報を発信しています。本記事のコードは静的検証済みです（構文・API仕様・ロジックを確認）。夜勤明けにGASを書くと、だいたい1回は「なんで動かないの？！」って叫びます。そんなときの頼れる相棒がconsole.log。今日は、GASでのデバッグの基本を、私の失敗談を交えて徹底的にお話しますね。

「GAS console.log」で検索してここに来た方が、読み終わったあと即コードに戻れるレベルで書いています。

こんな悩みありませんか？

  • 「エラーが出ないのに、なぜか結果がおかしい」
  • 「Logger.logとconsole.log、どっちを使えばいいの？」
  • 「ログをどこで見るのかわからない」
  • 「オブジェクトをconsole.logしたら[object Object]って出て中身が見えない」
  • 「ログが多すぎて、肝心な情報が埋もれる」

私も最初は画面とにらめっこで「なぜ…なぜ動かない…」ってやってました。ログをちゃんと出す習慣がつくと、トラブル解決の時間が体感1/3くらいになります。

GASのログは2系統：どっちを使うべき？

GASには伝統的に2つのログ方法があります。

方法見る場所特徴2026年の推奨度
console.log実行ログ（Cloud Logging）構造化ログ・レベル別表示◎
Logger.log実行ログ昔ながらの方法。現在も動く△

2026年から新しく覚えるならconsole.log一択でOKです。Logger.logも動きますが、新しいコードはconsole.logで統一すると一貫性が出て、Cloud Loggingとの連携もスムーズ。

console.logとLogger.logの違い

console.log('佐藤');        // 推奨：レベル別、構造化、複数引数
Logger.log('佐藤');          // 昔ながら：単純な文字列ログ
Logger.log('名前: %s', '佐藤'); // フォーマット指定もできる

Logger.logは単純な文字列ログ向け。console.logはレベル分け・複数引数・構造化出力ができるので、**どちらか迷ったらconsole**と覚えましょう。

ログはどこで見る？

GASエディタの左メニューから「実行数」、または関数実行後に下部に表示される「実行ログ」パネル。トリガー経由で動いた場合も、実行数の履歴から個別実行のログを開けます。

スマホのGoogle Apps ScriptアプリからもCloud Loggingが見えるので、外出先から夜勤中のGASの様子を確認できるのは地味に便利です。

console.log使いこなしの基本

1. 値の中身を見る

一番よく使うのがコレ。

function checkValue() {
  const name = '佐藤';
  const age = 38;
  console.log(name);
  console.log('年齢:', age);
}

カンマ区切りで複数の値を並べられるのがconsole.logの強み。テンプレートリテラルも便利です。

console.log(`名前: ${name} / 年齢: ${age}`);

2. オブジェクト・配列はそのまま投げる

文字列連結で+すると[object Object]になって泣きます。オブジェクトはそのまま渡しましょう。

const user = { name: '佐藤', shift: '夜勤' };

console.log('ダメな例: ' + user);        // [object Object] ← 泣く
console.log(user);                        // ✅ 構造化されて表示される
console.log(JSON.stringify(user));        // 文字列化したいときはこれ
console.log(JSON.stringify(user, null, 2)); // インデント付きで超見やすい

2次元配列の中身を確認するときも、JSON.stringifyが地味に便利。

const values = sheet.getDataRange().getValues();
console.log(JSON.stringify(values, null, 2));

3. ログレベルを使い分ける

consoleにはlog以外にもレベル別のメソッドがあります。

console.log('通常の情報');
console.info('参考情報');
console.warn('警告：値が空でした');
console.error('エラー：処理を中断します');

実行ログではレベルごとに色が変わるので、重要な警告・エラーが一目で見つかります。普段はlogだけで十分、問題の切り分け時にwarn・errorを使う、くらいの温度感で。

実務で効くデバッグテク7選

テク1：関数の入口と出口にログを置く

どこまで動いて、どこで止まったかが一発でわかる。

function fetchUsers() {
  console.log('[fetchUsers] 開始');
  // 処理...
  console.log('[fetchUsers] 終了 件数:', users.length);
  return users;
}

[関数名]を先頭に付けておくと、実行ログが長くなったときにCmd+Fで検索しやすいです。

テク2：ループの中で条件付きログ

全部出すとログが溢れるので、怪しい行だけピンポイントに。

values.forEach((row, i) => {
  if (row[0] === '') {
    console.warn(`[row ${i}] 空行を検出`);
  }
});

テク3：時間計測で処理の遅さを特定

処理が遅いときの原因特定に。

const start = new Date();
// 重い処理
const elapsed = new Date() - start;
console.log(`処理時間: ${elapsed}ms`);

console.time / console.timeEnd でもっと簡潔に書けます。

console.time('fetch');
// 重い処理
console.timeEnd('fetch'); // 「fetch: 1234ms」と出る

GASには6分制限があるので、時間計測は早めに仕込んでおくと、後で「なぜか止まる」という悲劇が減ります。

テク4：本番ではログを減らす

ログが多すぎると、肝心の情報が埋もれます。開発中は盛大に、本番は要点だけに絞るのが吉。フラグで切り替える手もあります。

const DEBUG = true;
function debugLog(...args) {
  if (DEBUG) console.log(...args);
}

// 呼び出し側はいつも通り
debugLog('デバッグ情報', someValue);

本番リリース時にDEBUG = falseにするだけで、デバッグログが全部止まります。

テク5：エラーをcatchしてログに残す

try {
  // 失敗するかもしれない処理
  const sheet = SpreadsheetApp.openById('unknown');
} catch (e) {
  console.error('[エラー]', e.message, e.stack);
}

e.stackまで出すと、どこでコケたか行番号まで追えます。

テク6：条件分岐のどこを通ったか確認

function route(value) {
  if (value > 100) {
    console.log('[route] A分岐');
  } else if (value > 50) {
    console.log('[route] B分岐');
  } else {
    console.log('[route] C分岐');
  }
}

「思っていない分岐を通っている」というバグは意外と多いので、分岐のたびにログを仕込むと発見が早いです。

テク7：ログのグループ化（整理用）

console.log('=== 集計開始 ===');
console.log('売上:', total);
console.log('件数:', count);
console.log('=== 集計終了 ===');

長い実行ログの中から「ここだ」と見つけるとき、区切り文字があると目で追えます。

ハマりがちなポイント

  • ログが出ない時：トリガー実行なら「実行数」から該当実行をクリック。エディタの実行ログには出ないので注意
  • 古いログが残る：GASのログは個別実行ごとに記録されるので、過去分と混同しないよう時刻を確認
  • 大量出力の注意：ループの中で毎回console.logすると、ログが数千行になって読めなくなる
  • Logger.logとの併用：混在すると見づらいので、プロジェクト内ではconsoleに統一するのが吉

まとめ

  • 新規コードはconsole.logで統一、Logger.logは過去の遺産
  • オブジェクトはそのまま渡す、配列はJSON.stringify(v, null, 2)が楽
  • log/info/warn/errorでレベル分けすると色が変わって見やすい
  • 関数の入口・出口ログで「どこまで動いたか」を可視化
  • console.timeで処理時間を計測、6分制限対策に必須
  • 本番ではDEBUGフラグでログを減らす

デバッグは探偵の仕事に似ています。ログは現場の証拠。ちゃんと残しておくと、犯人（バグ）はたいてい自分で出てきます。夜勤明けの頭でも安心して追えるように、ログ文化を育てていきましょう。

関連記事

この記事を書いた人：凛

2児のママで現役ナース。夜勤明けの細切れ時間を副業GASに投じ、月5〜8万円の副収入を継続中。「看護師でもコードは書ける」を合言葉に、家事育児とプログラミングを両立する等身大の情報を発信しています。本記事のコードは静的検証済みです（構文・API仕様・ロジックを確認）。

タグ: #GAS#デバッグ#ログ#console.log#Logger