Excel VBAのエラー一覧|原因の調べ方と確認する箇所を解説

コラム・裏ワザ
勇者たんたん
勇者たんたん

VBAテンプレートを変更したら、エラーが表示されて動かなくなりました。
どこを直せばよいのでしょうか?

VBAテンプレートを変更すると、エラーメッセージが表示され、処理が途中で止まることがあります。

「インデックスが有効範囲にありません」や「型が一致しません」と表示されても、初めて見るエラーでは、何を確認すればよいのか分かりにくいでしょう。

VBAでエラーが発生したときは、すぐにコード全体を書き換える必要はありません。

まずは、エラーメッセージ・[デバッグ]をクリックしたあとに黄色く表示される行・直前に変更した箇所を確認しましょう。

この記事では、VBAで発生する次のエラーについて、主な原因と確認方法を解説します。

  • コンパイルエラー
  • 実行時エラー9「インデックスが有効範囲にありません」
  • 実行時エラー13「型が一致しません」
  • 実行時エラー1004
  • ファイルが見つからないエラー
  • エラーは表示されないが、結果が間違っている場合

エラーの原因が分からない場合に、直前の変更を元へ戻して確認する方法も見ていきましょう。

今回のゴール

VBAのエラーメッセージと黄色く表示された行を確認し、直前に変更した箇所から原因を探せるようになる

VBAでエラーが発生したときに最初に確認すること

VBAでエラーが発生しても、すぐにコード全体を書き換えないようにしましょう。

エラー発生直後の確認事項
  1. エラーメッセージに何と表示されているか
  2. [デバッグ]をクリックしたあと、どの行が黄色く表示されるか
  3. エラーが発生する前に、どこを変更したか

VBAでエラーが発生したら、エラーメッセージ・黄色く表示された行・直前に変更した箇所の3つを確認しましょう。

エラーメッセージを確認する

エラーが発生すると、エラー番号や問題の内容がメッセージとして表示されます。

メッセージの例
  • コンパイルエラー
  • 実行時エラー「9」:インデックスが有効範囲にありません
  • 実行時エラー「13」:型が一致しません
  • 実行時エラー「1004」
  • 指定されたファイルが見つかりません

エラー番号やメッセージには、原因を調べるための手掛かりがあります。

メッセージを閉じる前に、次の内容をメモしておきましょう。

エラーメッセージに[終了]と[デバッグ]が表示されている場合は、[デバッグ]をクリックします。

[デバッグ]をクリックして黄色い行を確認する

実行時エラーの画面で[デバッグ]をクリックすると、VBEが開き、処理を続けられなくなったコードが黄色く表示されます。

たとえば、次のコードが黄色く表示されたとします。

Set ws = Worksheets("売上一覧")

この場合、VBAは「売上一覧」というシートを指定する処理で停止しています。

まずは、次の内容を確認しましょう。

  • 「売上一覧」というシートが存在する
  • コードと実際のシート名が一致している
  • シート名の前後に空白がない
  • 処理するブックを間違えていない

ただし、黄色く表示された行は、必ずしも原因そのものではありません。

VBAが処理を続けられなくなった場所として、その行で指定しているブック・シート・セル・値などを確認しましょう。

直前に変更した箇所を確認する

テンプレートを変更したあとにエラーが発生した場合は、直前に変更した箇所が原因の可能性があります。

エラーが発生した状態で別の箇所まで変更すると、原因を見つけにくくなります。

まずは直前の変更を元へ戻し、変更前の状態でマクロを実行してみましょう。

直前の変更を元へ戻して正常に動作した場合は、その変更箇所に原因がある可能性があります。ほかのコードを変更せず、入力した名前や記号を見直してください。

VBAエラーは3種類に分けて考える

VBAで問題が発生したときは、次の3種類に分けると原因を探しやすくなります。

種類発生する状態主な確認箇所
コンパイルエラーVBAがコードを正しく読み取れない記号、スペル、コードの組み合わせ
実行時エラーマクロの実行中に処理を続けられないブック名、シート名、フルパス、セル番地、値
想定と異なる結果マクロは最後まで動くが、正しい結果にならない条件、処理範囲、転記先、保存先

エラーが表示されたタイミングと、マクロがどこまで動いたかを確認すると、原因を探す範囲を絞れます。

コンパイルエラーとは?

コンパイルエラーとは、VBAがコードを正しく読み取れない状態です。

マクロを実行する前や、コードを入力している途中に表示される場合があります。

コンパイルエラーが表示された場合は、エラーメッセージで指摘された箇所と、直前に入力・変更したコードを確認しましょう。

実行時エラーとは?

実行時エラーとは、コードの読み取りには成功したものの、マクロの実行中に処理を続けられなくなった状態です。

実行時エラーは、コードの書き方が正しくても発生します。黄色く表示された行で、何を指定しているのか確認しましょう。

エラーが表示されなくても結果が間違う場合がある

マクロが最後まで実行されたが、目的どおりに処理されていないことがあります。

エラーが表示されなかっただけで、成功と判断しないでください。
データの転記や保存を行ったあとは、元データと処理結果を必ず確認しましょう。

コンパイルエラーの主な原因と確認方法

コンパイルエラーは、記号やコードの書き方に問題があり、VBAがコードを正しく読み取れないときに発生します。

VBAテンプレートを変更したあとにコンパイルエラーが表示された場合は、直前に変更したコードを確認しましょう。

初心者にありがちなコンパイルエラー
  • ダブルクォーテーションの不足や重複
  • IfとEnd Ifの組み合わせ
  • コードや変数名のスペル

ダブルクォーテーションの不足や重複を確認する

ブック名やシート名、フルパスなどの文字列は、前後をダブルクォーテーションで囲みます。

たとえば、「売上一覧」というシート名を変数へ代入するコードは、次のとおりです。

正しくダブルクォーテーションで囲んだ例
sheetName = "売上一覧"

間違えた例
sheetName = "売上一覧
sheetName = ""売上一覧""

文字を入力するときは、前後にダブルクォーテーションが1つずつあるか確認しましょう。

[パスのコピー]で取得したフルパスには、最初からダブルクォーテーションが付いている場合があります。

Excelファイルのフルパスを確認する方法については、次の記事で詳しく解説しています。

IfとEnd Ifの組み合わせを確認する

複数行で書かれたIf文は、条件を満たした場合の処理をEnd Ifまでの間に記述します。

If ws.Range("C2").Value = "未処理" Then
  ws.Range("D2").Value = "確認"
End If

IfからThenまで:確認する条件2行目:条件を満たした場合の処理
End If:If文の終わり

End Ifがない状態では、VBAがIf文の終わりを正しく判断できません。

反対に、対応するIfがない状態でEnd Ifだけが残っている場合も、コンパイルエラーの原因になります。

If文の条件だけを変更するときは、IfやThen、End Ifを削除せず、比較する文字や数値だけを変更しましょう。

If文と比較演算子の詳しい使い方については、次の記事で解説します。

コードや変数名のスペルを確認する

VBAコードの英単語や変数名に入力ミスがないか確認しましょう。

たとえば、次のコードではRangeのスペルが間違っています。

間違っている例
ws.Renge("B2").Value = "完了"

正しい例
ws.Range("B2").Value = "完了"

Rengeではなく、Rangeが正しいスペルです。

変数名も、同じ名前に統一する必要があります。

Dim sheetName As String
sheetName = "売上一覧"

Set ws = Worksheets(sheetNeme)

このコードでは、最後の行だけsheetNemeになっています。

正しくは、宣言したsheetNameを使用します。

SheetNameは同じ変数として扱われます。

Option Explicitの役割やVBAコードの基本構造については、次の記事で詳しく解説します。

コンパイルエラーを修正できたら、マクロをもう一度実行します。

エラーが表示されずに実行が始まった場合は、VBAがコードを読み取れる状態になっています。

よくある実行時エラーと確認方法

実行時エラーは、VBAがコードを読み取れたものの、マクロの実行中に処理を続けられなくなった場合に表示されます。

初心者にありがちな実行時エラー
  • 指定したブックやシートが存在しない
  • 変数へ合わない種類の値を渡している
  • 指定したセルや保存先を操作できない
  • フルパスの場所にファイルが存在しない

実行時エラーが表示されたら、[デバッグ]をクリックし、黄色く表示された行で何を指定しているのか確認しましょう。

実行時エラー9「インデックスが有効範囲にありません」の原因と対処法

実行時エラー9「インデックスが有効範囲にありません」は、コードで指定したブックやシートが見つからない場合に発生することがあります。

たとえば、次のコードでは「売上一覧」というシートを指定しています。

Set ws = Worksheets("売上一覧")

実際のExcelファイルに「売上一覧」シートが存在しない場合、VBAは指定されたシートを見つけられません。

最初に、次の内容を確認しましょう。

  • 指定したシートが存在する
  • コードとシート見出しの名前が一致している
  • シート名の前後に空白がない
  • 全角・半角や記号が一致している
  • 目的のブックを開いている
  • 目的のブックにあるシートを参照している

たとえば、コードでは「売上一覧」と指定していても、実際のシート名が「売上 一覧」であれば一致しません。

ブック名を指定している場合も、実際に開いているExcelファイルの名前と一致しているか確認します。

実行時エラー9が表示されたら、最初にブック名とシート名が実際の名前と一致しているか確認しましょう。

実行時エラー9は、配列の存在しない位置を指定した場合などにも発生します。

ブック名やシート名が書かれた場所を見つけられない場合は、次の記事を参考にしてください。

実行時エラー13「型が一致しません」の原因と対処法

実行時エラー13「型が一致しません」は、変数や処理に合わない種類の値を渡した場合に発生することがあります。

たとえば、次のコードでは、quantityを整数を入れるLong型として宣言しています。

正しい例
Dim quantity As Long
quantity = 100

間違えた例
Dim quantity As Long
quantity = "未入力"

この変数へ数値を代入する場合は、問題ありません。

一方、次のように「未入力」という文字列を代入すると、整数として扱えないため、実行時エラー13が発生します。

実行時エラー13が表示された場合は、次の内容を確認しましょう。

  • 数値を入れる変数へ文字列を渡していない
  • 日付を入れる変数へ日付として扱えない文字を渡していない
  • セルに想定していない文字やエラー値が入力されていない
  • InputBoxで入力された内容を正しく扱える
  • 変数のデータ型が処理する値に合っている

セルの値を変数へ代入している場合は、黄色く表示された行だけでなく、参照しているセルの内容も確認します。

quantity = ws.Range("B2").Value

セルB2に「未入力」や「なし」などの文字が入っている場合、Long型のquantityでは受け取れません。

実行時エラー13が表示されたら、コードだけでなく、参照しているセルにどのような値が入力されているかも確認しましょう。

変数とデータ型の詳しい使い方については、次の記事で解説します。

実行時エラー1004の主な原因と対処法

実行時エラー1004は、セルやシートの操作、ファイルの保存など、さまざまな場面で発生します。

原因をエラー番号だけで判断するのは難しいため、[デバッグ]をクリックし、黄色く表示された行を確認しましょう。

たとえば、次のコードが黄色く表示された場合は、セル番地や処理するシートを確認します。

ws.Range("B2").Value = "完了"

主な確認項目は、次のとおりです。

  • Rangeのセル番地が正しい
  • wsに目的のシートが設定されている
  • 対象のシートが保護されていない
  • 結合セルなど、処理しにくい状態になっていない
  • 保存先のフォルダーが存在する
  • 同名ファイルが使用中ではない
  • ブックやシートが閉じられていない

保存処理で実行時エラー1004が発生した場合は、保存先のフルパスやファイル名も確認します。

wb.SaveAs "C:\Users\ユーザー名\Documents\売上管理.xlsm"

指定したフォルダーが存在しない場合や、ファイルを保存できない状態では、処理を続けられません。

実行時エラー1004は原因が複数あるため、黄色く表示された行で、セル操作・シート操作・保存処理のどこに問題があるか確認しましょう。

ファイルが見つからない場合はフルパスを確認する

次のようなコードでエラーが発生した場合は、指定したフルパスを確認します。

Workbooks.Open "C:\Users\ユーザー名\Documents\売上管理.xlsm"

主な確認項目は、次のとおりです。

  • 指定した場所にファイルが存在する
  • ファイル名が一致している
  • .xlsxや.xlsmなどの拡張子が一致している
  • フォルダー名が途中で抜けていない
  • 全角・半角、空白、記号が一致している
  • OneDriveの同期が完了している
  • 共有フォルダーへアクセスできる

フルパスを手入力した場合は、入力ミスが発生しやすくなります。

対象ファイルをエクスプローラーで右クリックし、[パスのコピー]を使用して、フルパスを取得し直しましょう。

Excelファイルのフルパスを確認する方法については、次の記事で詳しく解説しています。

実行時エラーの原因を確認しても解決できない場合は、別のコードを追加する前に、直前の変更を元へ戻してみましょう。

直前に変更した箇所を元へ戻して確認する

エラーメッセージと黄色く表示された行を確認しても原因が分からない場合は、直前に変更した箇所を元へ戻しましょう。

正常に動いていたテンプレートが、コードの変更後に動かなくなった場合は、直前の変更に原因がある可能性があります。

エラー原因が分からないときの手順
  1. エラーメッセージとエラー番号を記録する
  2. [デバッグ]をクリックして、黄色く表示された行を確認する
  3. エラーが発生する前に変更した箇所を確認する
  4. 変更したコードを元の状態へ戻す
  5. マクロをもう一度実行する
  6. 正常に動作した場合は、変更内容を1つずつ見直す

たとえば、シート名を変更したあとに実行時エラー9が表示された場合は、変更前のシート名へ戻して確認します。

変更前
sheetName = "売上一覧"

変更後
sheetName = "請求一覧"

「請求一覧」へ変更したあとにエラーが発生した場合は、一度「売上一覧」へ戻してマクロを実行します。

変更前の状態で正常に動作すれば、次のような原因が考えられます。

  • 「請求一覧」というシートが存在しない
  • シート名に空白や記号が含まれている
  • 実際のシート名とコードの文字が一致していない
  • 目的とは異なるブックを参照している

変更前へ戻すと正常に動く場合は、直前に変更した箇所を重点的に確認しましょう。

変更前のコードが分からなくならないように、VBAテンプレートを編集する前に元のExcelファイルをコピーしておくことが大切です。

テスト用ファイルでエラーが発生しても、元ファイルと比較すれば、変更した箇所を確認できます。

変更前の状態で正常に動作したら、目的の変更を1か所だけ行います。

エラーを放置しない

エラーが発生した状態で、別の箇所まで続けて変更しないでください。

変更箇所が増えると、どの変更が原因なのか判断しにくくなります。

エラーを無理に非表示にしない

エラーが表示されると、インターネット上で見つけた次のコードを追加したくなる場合があります。

以下はエラーが発生したあとも、次の処理へ進むためのコードです。

エラーが発生したあとも、次の処理へ進むためのコード
On Error Resume Next

ただし、エラーの原因を修正するコードではありません。

原因を確認せずに追加すると、処理に失敗していることに気づかないまま、次のコードが実行される可能性があります。

たとえば、ファイルを開けなかったあとも処理を続けると、次のような問題につながります。

  • 目的とは異なるブックが処理される
  • データが正しい場所へ転記されない
  • 必要なファイルが作成されない
  • 完了していないのにMsgBoxで「完了」と表示される
  • 既存のデータやファイルが上書きされる

原因が分からないまま、On Error Resume Nextを追加してエラーを無視しないでください。
まずはエラーメッセージ、黄色い行、直前の変更箇所を確認しましょう。

まとめ|黄色い行と直前の変更箇所を確認しよう

VBAでエラーが発生したときは、手当たり次第にコードを変更せず、エラーメッセージと黄色く表示された行を確認しましょう。

エラーごとの対処

コンパイルエラー

  • ダブルクォーテーションの不足や重複
  • IfとEnd Ifの組み合わせ
  • コードや変数名のスペル

実行時エラー

  • 実行時エラー9:ブック名やシート名
  • 実行時エラー13:変数のデータ型やセルの値
  • 実行時エラー1004:セル、シート、保存先など、停止した処理
  • ファイルが見つからない場合:フルパス、ファイル名、拡張子

原因が分からないエラー

  1. エラーメッセージと番号を記録する
  2. [デバッグ]をクリックする
  3. 黄色く表示された行を確認する
  4. 直前に変更した箇所を元へ戻す
  5. 1か所だけ変更して再度実行する
  6. エラーが消えたあと、実際の処理結果を確認する

変更前の状態で正常に動き、1か所を変更するとエラーが発生する場合は、その変更箇所を重点的に確認しましょう。

エラーを無理に非表示にするのではなく、原因を確認してからマクロをもう一度実行しましょう。

VBAの基本構造やブック・シート・セルの指定方法を理解していると、黄色く表示されたコードの意味を判断しやすくなり、エラーの原因も見つけやすくなります。

VBAを基礎から順番に学びたい場合は、次の記事を参考にしてください。

コメント

タイトルとURLをコピーしました