先生と生徒の会話形式で理解しよう

生徒

「Office Scriptsを書いてみたんですが、うまく動かないときに原因が分からなくて困っています……。」

先生

「その場合は、ログやデバッグ用のコードを入れて処理の流れを確認すると分かりやすくなります。」

生徒

「ログやデバッグって、たくさん書くと逆に分かりにくくなりませんか？」

先生

「だからこそ、整理された書き方が大切です。Office Scriptsでも初心者向けの方法がありますよ。」

1. ログとデバッグとは何か

Office ScriptsでExcel自動化を行うとき、思った通りに動かないことはよくあります。その原因を探すために使うのがログとデバッグです。ログとは、プログラムの途中経過を文字として残すことです。ノートに途中経過を書きながら作業するのと同じで、今どこまで進んだのか、どんな値になっているのかを確認できます。デバッグとは、プログラムの間違いを見つけて直す作業全体のことを指します。 Office Scriptsでは難しい道具を使わなくても、簡単な方法でデバッグができます。

2. Office Scriptsでログを書く基本

Office Scriptsでは、コードの中に確認用の処理を書くことでログの代わりにできます。初心者のうちは「ちゃんとここまで動いているか」を確認するだけで十分です。例えば、セルに文字を書き込んで確認する方法があります。 Excelの画面に直接結果が見えるので、パソコンに不慣れな人でも安心です。このような確認用コードも立派なログです。


function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  sheet.getRange("A1").setValue("ここまで処理が進みました");
}

3. 一時的なデバッグコードの考え方

デバッグ用に書いたコードは、ずっと残しておくものではありません。問題が解決したら消す、これが整理の基本です。例えば、計算結果を確認したいときだけセルに値を書き込み、確認が終わったら削除します。料理中に味見をするためのスプーンのようなもので、使い終わったら片付けます。 Office Scriptsのプロジェクト構成をきれいに保つためにも、一時的なコードだと分かるようにまとめて書く習慣が大切です。


function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  const value = sheet.getRange("B1").getValue();
  sheet.getRange("C1").setValue("確認用：" + value);
}

4. コメントを使ったログ整理

コメントとは、プログラムとしては動かない説明文のことです。 Office Scriptsでは「//」から始めるとコメントになります。ログやデバッグコードを整理するとき、コメントはとても役立ちます。なぜこの確認をしているのかを書いておくと、後から見返したときに迷いません。初心者ほど、コメントをたくさん書くことが大切です。自分へのメモだと思ってください。


function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();

  // デバッグ用：A1の値を確認する
  const checkValue = sheet.getRange("A1").getValue();
  sheet.getRange("D1").setValue(checkValue);
}

5. ログ用セルやシートを決める

ログやデバッグ結果をあちこちのセルに書くと、Excelが見づらくなります。そのため、あらかじめ「ログ専用のセル」や「確認用シート」を決めると整理しやすくなります。例えば、一番右の列だけをログ用にする、あるいは「DEBUG」という名前のシートを作る方法です。こうすると、作業用データと確認用データが混ざらず、Office Scriptsの管理が楽になります。


function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  sheet.getRange("Z1").setValue("ログ：処理開始");
}

6. ログを消すタイミングと注意点

デバッグが終わったら、ログ用コードや確認用の書き込みは消しましょう。残したままだと、後で自動化を実行したときに不要な文字が表示されてしまいます。特にOffice Scriptsを業務で使う場合、利用者が混乱する原因になります。整理されたコードは読みやすく、ミスも減ります。「確認用は最後に消す」という流れを習慣にすることが、コード管理の第一歩です。


function main(workbook: ExcelScript.Workbook) {
  const sheet = workbook.getActiveWorksheet();
  // 本番用ではログ出力を行わない
  sheet.getRange("A1").setValue("処理完了");
}

7. 初心者が意識したいデバッグ整理のコツ

Office Scriptsでのログやデバッグコード整理は、難しい技術ではありません。一時的に書く、コメントを残す、置き場所を決める、終わったら消す。この四つを守るだけで、プロジェクト構成はとても分かりやすくなります。プログラミング未経験の人でも、紙にメモを取りながら作業する感覚で進めれば大丈夫です。 Excel自動化を安心して続けるためにも、ログとデバッグの整理を最初から意識しましょう。